Retrieve a member of a profile list using RIID

Existing members of a profile list can be retrieved one at a time by using the Responsys ID (RIID).

REQUEST NOTES:

  • The total length of the string passed in for the fs parameter (containing the comma separated field names) cannot exceed 150 characters.
  • To retrieve values of all columns, you can specify only one field with value set to ‘all’ (if you have a column called ‘all’, you should use two or more specific column names to avoid getting all of the columns).

Service URL:

/rest/api/v1.3/lists/{listName}/members/{riid}

Request Method:

GET

Request Header:

Authorization=<AUTH_TOKEN>

Request parameters:

fs - comma separated list of fields to retrieve or ‘all’

Request Body:

None

Sample Response in case of success:

RESPONSE NOTE: Other attributes in the response like mapTemplateName and mergeRule will have default values of null/false.

{
  "recordData": {
    "fieldNames": [
      "RIID_",
      "EMAIL_ADDRESS_",
      "CUSTOMER_ID_"
    ],
    "records": [
      [
        "4094330",
        "ab.na@gmail.com",
        null
      ],
      [
        "4094326",
        "ab.cd@gmail.com",
        null
      ]
    ],
    "mapTemplateName": null
  },
  "mergeRule": {
    "textValue": null,
    "insertOnNoMatch": false,
    "updateOnMatch": null,
    "matchOperator": null,
    "matchColumnName3": null,
    "matchColumnName1": null,
    "matchColumnName2": null,
    "optinValue": null,
    "optoutValue": null,
    "rejectRecordIfChannelEmpty": null,
    "htmlValue": null,
    "defaultPermissionStatus": null
  },
  "links": [
    {
      "rel": "self",
      "href": "/rest/api/v1.3/lists/DemoNewsLetterList/members?qa=m&amp;fs=riid_,email_address_,customer_id_&amp;id=9845349498",
      "method": "GET"
    },
    {
      "rel": "mergeListRecipients",
      "href": "/rest/api/v1.3/lists/DemoNewsLetterList/members",
      "method": "POST"
    },
    {
      "rel": "deleteListRecipientsRIID",
      "href": "/rest/api/v1.3/lists/DemoNewsLetterList/members/<riid>",
      "method": "DELETE"
    }
  ]
}

Sample Response in case of failure:

{
   "type": "",
   "title": "Record not found",
   "errorCode": "RECORD_NOT_FOUND",
   "detail": "No records found in the list for given ids",
   "errorDetails": []
}