Get a subscriber
GET/subscriber/:email
Get a subscriber by email
Request
Path Parameters
email stringrequired
Subscriber email address
Header Parameters
x-api-key stringrequired
Your API key
x-developer-mode boolean
Enable developer mode. Learn more here.
Responses
- 200
- 404
- 500
Subscriber found.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
data object
id string
email emailrequired
Subscriber email address
phone phone
Subscriber phone number. It follows the E.164 format.
name string
Subscriber name
status string
Possible values: [free_subscriber
, paid_subscriber
, unsubscribed_subscriber
]
Subscriber status
customFields object[]
List of custom fields. Each custom field has a label, and value.
id string
Custom field ID
label string
Custom field label
value string
Custom field value
segmentationLists string[]
List of segmentation lists IDs. You can get the ID by calling our support team.
blacklistedAt date-time
Subscriber blacklisted date
unsubscribedAt date-time
Subscriber unsubscribed date
createdAt date-time
Subscriber creation date
updatedAt date-time
Subscriber update date
requestId string
{
"data": {
"id": "string",
"email": "example@email.com",
"phone": "+5511999999999",
"name": "John Doe",
"status": "free_subscriber",
"customFields": [
{
"id": "string",
"label": "age",
"value": 25
}
],
"segmentationLists": [
"ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f",
"ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
],
"blacklistedAt": "2024-04-09T19:18:29.655Z",
"unsubscribedAt": "2024-04-09T19:18:29.655Z",
"createdAt": "2024-04-09T19:18:29.655Z",
"updatedAt": "2024-04-09T19:18:29.655Z"
},
"requestId": "string"
}
Subscriber not found.
- application/json
- Schema
- Example (from schema)
Schema
error string
errorCode string
requestId string
{
"error": "Subscriber not found.",
"errorCode": "SUBSCRIBER_NOT_FOUND",
"requestId": "ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
}
Internal server error.
- application/json
- Schema
- Example (from schema)
Schema
error string
errorCode string
requestId string
{
"error": "Internal server error.",
"errorCode": "INTERNAL_SERVER_ERROR",
"requestId": "ff37b0a8-de19-4f72-a7ed-0bd1cb73f29f"
}
Loading...