Search for subscribers in one or more segments and retrieve their email addresses and custom field values (optional).


System runs asynchronously in the background to allow retrieving payloads for larger segments. User has option of receiving notification of call completion and a link to download either the JSON or CSV file via email or by webhook.   


JSON Request Example:


{
  "username": "johndoe",
  "usertoken": "abc123abc123abc123abc123abc123",
  "requesttype": "Segments",
  "requestmethod": "GetSegmentSubscribersAsync",
  "details": {
    "segmentid": ["{*segment_id*}", "{*segment_id*}"], /* required: at least one */
    "status": "{*status: any|active|inactive|bounced|unsubscribed*}", /* optional: default any */
    "include_membership": "{*include_membership_boolean*}", /* optional: include tab membership */
    "customfields": ["{*customfield_name*}"], /* optional: multi, use 'all' for all */
    "format": "{*csv|json*}", /* optional: default json */
    "notify": { /* required */
      "type": "{*notification_type*}", /* required: email or webhook */
      "value": "{*notification_target*}" /* required: email-address or webhook-url */
    }
  }
}


"json_request"  element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeSegments
requestmethodGetSegmentSubscribersAsync


"details" 


Field NameDescription
segmentidID of segment to be searched.
Can add multiple segment IDs to search more than one segment.
status
(optional)
Status of contacts to be searched for. Value can be any, active, inactive, bounced or unsubscribed. Default is any.


"customfields" element


customfields (optional)User may retrieve a contact's custom field values by specifying the name(s) of the custom fields to be be returned, or by entering "all" as the parameter value.


"format" element


formatUser can select whether to receive the payload in either CSV or JSON format.


"notify" element


type (required)Method by which user wishes to be notified that the call has completed processing and what the link to the JSON file is: either "email" or "webhook"
value (required)If user selects notification via email, they must provide a valid email address which will receive the email notification. If user selects notification via webhook, they must provide a valid webhook URL to receive the payload, including the link to the JSON file. 


Successful Response:


"response" element


Field NameDescription
statusWill return SUCCESS if call was successfully completed.
dataReturns job ID


Example of returned data:


(Where user has selected "email-address" as notification method and provided an email address):



(Where user has selected "webhook-url" as notification method and provided a webhook URL): 




Unsuccessful Response:


"response" element


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