menu
Count contacts
Counts contacts, honoring the same search, exact-email, and status filters as the contact list.
Endpoint
GET https://api.sendstreak.com/v2/accounts/{accountId}/contacts/count
All v2 endpoints require a bearer token - see Authentication.
Path parameters
| Parameter | Type | Description |
|---|---|---|
accountId | string | The account the request is scoped to. |
Query parameters
| Parameter | Type | Description |
|---|---|---|
search | string | |
email | string (email) | Exact email match (case-insensitive); takes precedence over search. Mirrors the list filter. |
status | one of: bounced, unsubscribed |
Response
The matching count.
{
"count": 42
}
Errors
| Status | Description |
|---|---|
401 | Missing or invalid token, or the token is not authorized for this account/user. |
See Errors and rate limits for what error responses look like.
Curl example
curl --location --request GET 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/count' \
--header 'Authorization: Bearer YOUR_API_TOKEN'