Check subscribers

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

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]"
}

{
  "subscriberId": "f3a5e5afda82acd2569415e869193d9d"
}

string

The email address of the subscriber you want to check

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

400 Bad Request

Returned when neither email nor subscriberId is provided.

{
    "error": "Either email or subscriberId must be provided"
}

404 Not Found

Returned when the subscriber is not found.

{
    "error": "Subscriber not found"
}

500 Internal Error

Returned when an unexpected error occurs.

{
    "error": "Internal Server Error"
}

Get started

Verify

Users

Subscribers

Check subscribers

Authorization

Request Body

Response

Error Responses

​Authorization

​Request Body

​Response

​Error Responses

Authorization

Request Body

Response

Error Responses