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

# Estimate Push Campaign Recipients

> Count audience contacts with an active device

# Estimate Push Campaign Recipients

Counts the contacts in an audience (`audienceCount`) and those with an active device on the selected platforms (`eligibleCount`). Email status does not affect push eligibility. Requires the `campaigns:read` scope.

## Request

<ParamField body="targetLists" type="object" required>
  Audience, same shape as campaign `targetLists`.
</ParamField>

<ParamField body="platforms" type="string[]">
  Only count devices on these platforms.
</ParamField>

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/push/campaigns/estimate" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"targetLists":{"type":"all"}}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "audienceCount": 1200,
    "eligibleCount": 340
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Invalid audience."
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "API key is missing required scope: campaigns:read"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.