Skip to main content
Use this endpoint to check if a subscriber exists and retrieve their information using either their email or subscriber ID.
POST
https://api.taag.cc/v1/subscribers/check

​
Authorization

All you need is to include your secret key as a value of authorization in the header and hit the endpoint above. 
Authorization: taag_sk_mode_xxxxxxxxx
​
Authorization
string
required
Use the secret key that matches the mode you are in TEST or LIVE

​
Request Body

You must provide either an email or subscriberId to look up the subscriber. 
{
  "email": "[email protected]"
}
OR 
{
  "subscriberId": "f3a5e5afda82acd2569415e869193d9d"
}
​
email
string
The email address of the subscriber you want to check
​
subscriberId
string
The unique subscriber ID of the subscriber you want to check
At least one of email or subscriberId must be provided in the request body.

​
Response

If the subscriber is found, you will receive an object containing the subscriber’s details. 
{
  "mode": "TEST",
  "subscriber": {
    "email": "[email protected]",
    "firstName": "Steve",
    "lastName": "Jobs",
    "subscriberId": "f3a5e5afda82acd2569415e869193d9d",
    "status": "SUBSCRIBED",
    "countryCode": "US",
    "createdAt": "2025-08-26T18:45:40.567Z"
  }
}

​
Error Responses

Returned when neither email nor subscriberId is provided.
{
    "error": "Either email or subscriberId must be provided"
}
Returned when the subscriber is not found.
{
    "error": "Subscriber not found"
}
Returned when an unexpected error occurs.
{
    "error": "Internal Server Error"
}