Count contacts
Counts contacts, honoring the same search, exact-email, and status filters as the contact list.
GET
/v2/ accounts/ {accountId}/ contacts/ countPath 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'
const res = await fetch('https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/count', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.SENDSTREAK_TOKEN}`
}
});
import os, requests
res = requests.get(
'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/count',
headers={'Authorization': f"Bearer {os.environ['SENDSTREAK_TOKEN']}"},
)
{
"count": 42
}