Participant APIs | REST

Version:
Download Open API Specification

Returns a list of participant communications

https://beta.api.wealthcare.com/participant/services/participant/communications/items/{tpaId}/{employerId}/{participantId}

Retrieve a list of communications for a specific participant, identified by their unique TPA ID, Employer ID, and Participant ID. This endpoint is useful for accessing various communication types, including letters, emails, and SMS messages sent to the participant.

  • tpaId string Required

    A unique identifier used to identify your admin instance. This value is system generated when the admin instance was created.

  • employerId string Required

    Unique identifier for the employer. Note: When the employer was created, WealthCare Admin assigned the 3-character prefix; you assigned the remaining characters.

  • participantId string Required

    Unique identifier for the participant whose features are being queried.

  • type string

    Specifies the type of communication to retrieve. Use "1" to return only letter communications; otherwise, non-letter types (Email and SMS) will be returned.

  • decrypt integer <int32>

    Indicate if the URI parameters are encrypted or not. Use 1 for encrypted and 0 for decrypted; defaults to 0 if not specified.

  • showLetter string

    Determines whether letter communications are included in the response. Set to "1" to include letters, or "0" to exclude them.

  • array <object>
    • CommHistKey integer <int64>

      Communication History Key (id)

    • CustTempType integer <int32>

      Custom Template Type - Enum CustomTemplateType (ie: Billing Address Change, Shipping Address Change)

    • CustTempName string

      Custom Template Name

    • CustTempKey integer <int32>

      Custom Template Key (id)

    • ChannelKey integer <int32>

      Channel Key - Enum CommunicationChannel (0 = None, 1 = Email, 2 = Mobile, 3 = Both, 4 = LetterCommunication, 8 = NotifyEmail, 16 = MailedLetter, 32 = SendEmailToTaxFormsAcctHolders)

    • FormatKey integer <int32>

      Format Key - Enum CommunicationFormat (1 = Text, 2 = HTML)

    • Subject string

      Email Subject Line

    • MobileNumber string

      Mobile Number

    • InsertDte string <date-time>

      Insert Date (DateTime)

    • UpdateDte string <date-time>

      Update Date (Nullable DateTime)

    • CommunicationType enum<string>

      Communication Type

      Possible values: Email SMS Letter