Retrieve the specified subscriber who may be on one or more lists, including their respective custom field data.


Note:  A truncated version of this API call can also be found under the requesttype of "Lists".


JSON request example:



{
  "username": "JohnDoe",
  "usertoken": "abc123abc123abc123abc123",
  "requesttype": "Subscribers",
  "requestmethod": "GetSubscribers",
  "details": {
    "searchinfo": {
      "list": ["{*list_id*}", "{*list_id*}"], /* required: at least one */
      "email": "{*email_address*}"
      "customfields": ["{*customfield_name*}", "{*customfield_name*}", "all"],
    "pagination": {
      "limit": "{*max_records*}",
      "next": "{*start_at_record_number*}"
    },
    "sort": {
      "field": "{*sort_field*}",
      "direction": "{*sort_direction: asc|desc*}"
    },
    "include_membership": "{*include_membership_boolean*}"
  }
}


"jsonrequest" element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeSubscribers
requestmethodGetSubscribers


Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. For example, if no <customfield> value is inserted, the <customfield> tags should be deleted. 


"details" element


Field NameDescription
list
(At least one required)
ID of list(s) to be searched for the specified contact.
email
Email address of contact to search for.
customfieldComma-separated list of custom field IDs. Or user may use the default "all" value provided.


"details"

"pagination" OPTIONAL


Field NameDescription
limitEnter an integer to set the numerical limit for number of subscriber records that will be returned from a single call. 
nextStarting subscriber record number for a given call. If element is deleted, default is 0 (first record).


"details"

"sort" OPTIONAL


Field NameDescription
fieldID of custom field to be added. If <sort> tag deleted, system will sort by subscribers' email address. 
directionSort order of either ascending or descending. 
 

"include_membership" element


include_membership
(optional)
PieSync requirement: Setting this element's value to true, 1 or yes results in the API call adding a list of all tags that a subscriber is in as part of the returned information for that subscriber.


Successful Response:

"response" element


Field NameDescription
statusWill return SUCCESS if subscriber and list successfully found


"data"

"item" element


System will return a full dataset of subscriber attribute values on the found subscriber,


Unsuccessful Response:


"response" element


Field NameDescription
statusWill return FAILED if unsuccessful
errormessageText explaining why request failed