Load Contact

This documentation will describe the load contact option available when using the Update Contact Information (XMMDALL1) endpoint. This option allows users to view contact information data entered on accounts.

See the Authentication documentation for information on how to obtain the authentication headers within the request.

Use cases

  • Viewing contact information
  • Obtain contact information prior to editing it

Prior to viewing contacts, confirm you’ve locked the account as explained in the Data Entry Endpoints Introduction documentation.

Once edits are complete, follow the same documentation to release the account.

Load contact

View all contact information assigned to the specified account.

Supported attributes

AttributeTypeRequiredDescription
*setMethodstringYesDetermines the endpoint you are calling. Must be XMMDALL1 to interact with contacts.
OPTIONstringYesDetermines the method you will be using. Must be LOAD to view contact information.
ACCOUNT_NUMBERstringYesThe subscriber account number (9 character max).
RESERVED_MDAstringYesThe session ID used when locking the account. The session ID must match to access account information.

Example request

curl --location "https://example.securemcloud.com/rest/rest.php?dataSource=methods&*view=xmsubmit" \
--header 'X-DICE-APPKEY: {{X-DICE-APPKEY}}' \
--header 'X-DICE-USERNAME: {{X-DICE-USERNAME}}' \
--header 'X-DICE-DATE: {{X-DICE-DATE}}' \
--header 'X-DICE-NONCE: {{X-DICE-NONCE}}' \
--header 'X-DICE-DIGEST: {{X-DICE-DIGEST}}' \
--header 'Accept: application/json' \
--form '*setMethod=XMMDALL1' \
--form OPTION=LOAD \
--form ACCOUNT_NUMBER=KMN12 \
--form RESERVED_MDA=_DOC

Example response

{
  "PMCONCT": {
    "ALCONCT": [
      {
        "ACCOUNT_NUMBER": "    KMN12",
        "DEFAULT_LIST_NO": "02",
        "CONTACT_NAME": "Premises Contact    ",
        "CONTACT_PHONE": "  (555) 323-4452",
        "CONT_BEG_DATE": "000000",
        "CONT_END_DATE": "999999",
        "CONT_BEG_TIME": "0000",
        "CONT_END_TIME": "2400",
        "PERSONAL_INFO": "Testing Edits                 ",
        "CHANGED_DATE": "03/23/2026",
        "CHANGED_OPR": "KMN",
        "LIMITED_AREAS": "N",
        "MODIFY_OWN_DATA": "A",
        "PAGER_YN": "N",
        "CONTACT_TYPE": "05",
        "COUNTRY": "USA",
        "CONTACT_PHONE_F": "!",
        "SORT_PHONE": "5553234452      ",
        "NO_AREA_CODE_SORT": "3234452         ",
        "PHONE_EXTENSION": "444     ",
        "PASSCODE_HONORS_HRS": "N",
        "INCLUSIVE_DATE_TIME": "N",
        "SMS_NOTIFY": "N",
        "E_MAIL_ADDRESS": "email@example.com"
      }
    ]
  },
  "XMCONCT": {
    "ALCONCT": [
      {
        "ACCOUNT_NUMBER": "    KMN12",
        "DEFAULT_LIST_NO": "12",
        "CONTACT_NAME": "Jessica Sage        ",
        "CONTACT_PHONE": "  (555) 523-4230",
        "CONT_BEG_DATE": "000000",
        "CONT_END_DATE": "999999",
        "CONT_BEG_TIME": "0000",
        "CONT_END_TIME": "2400",
        "PERSONAL_INFO": "Documentation Intern          ",
        "PASSCODE": "7606383656     ",
        "CHANGED_DATE": "03/23/2026",
        "CHANGED_OPR": "KMN",
        "LIMITED_AREAS": "N",
        "MODIFY_OWN_DATA": "A",
        "PAGER_YN": "N",
        "DEFAULT_SORT_NO": "005",
        "CONTACT_TYPE": "07",
        "COUNTRY": "USA",
        "CONTACT_PHONE_F": "!",
        "SORT_PHONE": "5555234230      ",
        "NO_AREA_CODE_SORT": "5234230         ",
        "MUST_CALL": "N",
        "STORE_PASSCODE_PRINT": "N",
        "PASSCODE_HONORS_HRS": "N",
        "INCLUSIVE_DATE_TIME": "N",
        "SMS_NOTIFY": "N"
      }
    ]
  },
  "ALSCRPHD_LIST": {
    "ALSCRPHD": [
      {
        "OPTIONAL_SCRIPT": "DEFAULTS",
        "CONTACT_TYPE": "05",
        "SCRIPT_DESCRIPTION": "Premise                       ",
        "INITIAL_SCREEN": "ALSCRPRM",
        "CALL_BACK_SCREEN": "ALSCRPRM",
        "POST_DISP_SCREEN": "ALSCRPRM"
      }
    ]
  },
  "ALCONCTX_LIST": {
    "ALCONCTX": [
      {
        "EXCEPTION_TYPE": "S",
        "EXCEPTION_DESC": "S GROUP                                 "
      }
    ]
  }
}