Count contacts

Counts contacts, honoring the same search, exact-email, and status filters as the contact list.

GET/v2/accounts/{accountId}/contacts/count

Base URL https://api.sendstreak.com. All v2 endpoints require a bearer token - see Authentication.

Path parameters

accountIdstringrequired

The account the request is scoped to.

Query parameters

searchstringoptional

emailstring (email)optional

Exact email match (case-insensitive); takes precedence over search. Mirrors the list filter.

statusone of: bounced, unsubscribedoptional

Response

The matching count.

Errors

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 --location --request GET 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/count' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
response200application/json
{
  "count": 42
}