Retrieve people’s subscription statuses (subscriptions)
The subscriptions
Ortto endpoint of the person
entity is used to retrieve subscription statuses from one or more person records in Ortto’s customer data platform (CDP).
This page provides descriptions of this endpoint’s:
-
valid parameters, headers, and request body values, as well as
-
the response payload.
Headers
This endpoint requires a custom API key and content type (application/json
for the request body) in the header of the request:
-
X-Api-Key: CUSTOM-PRIVATE-API-KEY
-
Content-Type: application/json
Request body
The request body consists of a JSON object whose valid elements are listed in the table below.
The following JSON object is an example of field and object data that Ortto can recognize to get data from one or more person records in your Ortto account’s CDP.
{
"people": [
{
"email": "chris@example.com"
}
]
}
Valid request body elements
The following table lists all valid request body elements (arrays, objects, or fields), which are available to this endpoint.
Element | Type | Required | Description | |
---|---|---|---|---|
|
|
Required |
The
The API will defer to |
|
|
|
Optional (at least one string required) |
The email address of the person whose subscription statuses you wish to retrieve. |
|
|
|
Optional (at least one string required) |
A string identifying the person by their unique ID number. |
|
|
|
Optional (at least one string required) |
A string identifying the person by their external ID number. |
Response payload
The response payload consists of a JSON object whose elements are listed in the table below.
The following JSON object is an example of people’s data that Ortto retrieves from your Ortto account’s CDP after a request to this endpoint.
{
"people": [
{
"person_status": "merged",
"person_id": "00624536230993474f078a00",
"subscriptions": [
{
"audience_id": "625f7213a914327aa1999b43",
"audience_name": "Weekly updates",
"member_from": "2022-04-20T02:38:11Z",
"subscribed": true,
"subscribed_from": "2022-04-20T02:38:11Z",
"sms_opted_in": false
},
{
"audience_id": "6241681069639ee210f8a298",
"audience_name": "Subscribers",
"member_from": "2022-03-31T05:03:31Z",
"subscribed": true,
"subscribed_from": "2022-03-31T05:03:31Z",
"sms_opted_in": false
},
{
"audience_id": "6241681069639ee210f8a29a",
"audience_name": "Engaged subscribers",
"member_from": "2022-03-31T12:56:14Z",
"subscribed": true,
"subscribed_from": "2022-03-31T12:56:15Z",
"sms_opted_in": false
}
],
"email_permissions": true,
"sms_permissions": false
}
]
}
Response payload elements
The following table lists all elements (arrays, objects, or fields) in the response from a request to this endpoint.
Element | Type | Description | ||
---|---|---|---|---|
|
|
The * * * |
||
|
|
Identifies the person’s data as having been merged into your customer data platform (CDP). |
||
|
|
A string identifying the person by their unique ID number. |
||
|
|
An array of fields identifying the audiences the person is a member of, and their email and SMS subscription status for those audiences. |
||
|
|
The unique identification number for the audience. |
||
|
|
The name of the audience in your Ortto account (note, this is not the public audience name). |
||
|
|
The date and time the person became a member of the audience. Format is ISO 8601. |
||
|
boolean |
If |
||
|
|
The date and time the person became a subscriber of the audience. Format is ISO 8601. |
||
|
|
The date and time the person became unsubscribed from the audience. Format is ISO 8601. |
||
|
boolean |
If |
||
|
|
The date and time the person became opted-out from SMS for the audience. Format is ISO 8601. |
||
|
|
If |
||
|
|
If |