> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taag.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Check subscribers

Use this endpoint to check if a subscriber exists and retrieve their information using either their email or subscriber ID.

```method: POST theme={null}
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.

```bash theme={null}
Authorization: taag_sk_mode_xxxxxxxxx
```

<ParamField path="Authorization" type="string" required> Use the secret key that matches the mode you are in TEST or LIVE </ParamField>

## Request Body

You must provide either an email or subscriberId to look up the subscriber.

```bash theme={null}
{
  "email": "stevejobs@apple.com"
}
```

**OR**

```bash theme={null}
{
  "subscriberId": "f3a5e5afda82acd2569415e869193d9d"
}
```

<ParamField body="email" type="string"> The email address of the subscriber you want to check </ParamField> <ParamField body="subscriberId" type="string"> The unique subscriber ID of the subscriber you want to check </ParamField>

<Note>At least one of **email** or **subscriberId** must be provided in the request body.</Note>

## Response

If the subscriber is found, you will receive an object containing the subscriber's details.

```bash theme={null}
{
  "mode": "TEST",
  "subscriber": {
    "email": "stevejobs@apple.com",
    "firstName": "Steve",
    "lastName": "Jobs",
    "subscriberId": "f3a5e5afda82acd2569415e869193d9d",
    "status": "SUBSCRIBED",
    "countryCode": "US",
    "createdAt": "2025-08-26T18:45:40.567Z"
  }
}
```

## Error Responses

<AccordionGroup>
  <Accordion title="400 Bad Request">
    Returned when neither email nor subscriberId is provided.

    ```bash theme={null}
    {
        "error": "Either email or subscriberId must be provided"
    }
    ```
  </Accordion>

  <Accordion title="404 Not Found">
    Returned when the subscriber is not found.

    ```bash theme={null}
    {
        "error": "Subscriber not found"
    }
    ```
  </Accordion>

  <Accordion title="500 Internal Error">
    Returned when an unexpected error occurs.

    ```bash theme={null}
    {
        "error": "Internal Server Error"
    }
    ```
  </Accordion>
</AccordionGroup>