Skip to main content
GET
/
v2
/
audiences
/
{id}
/
size
curl -X GET "https://api.tracklysms.com/api/v2/audiences/664f1a2b3c4d5e6f7a8b9c0d/size" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "audience_id": "664f1a2b3c4d5e6f7a8b9c0d",
  "size": 12480,
  "calculated_at": "2025-11-20T10:30:45"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt

Use this file to discover all available pages before exploring further.

Calculates the current number of contacts matching the audience’s filter in real time. This operation runs the filter query against your contact database and updates the audience’s cached_size and cached_size_updated_at fields.
Size calculations run in real time against your contact database. For audiences with complex filters or large contact lists, this may take several seconds to complete.

​
Path Parameters

​
id
string
required
The unique identifier of the audience.

​
Response Fields

​
audience_id
string
The audience ID that was calculated.
​
size
integer
The current number of contacts matching the audience filter.
​
calculated_at
datetime
Timestamp when the calculation was performed.

​
Examples

curl -X GET "https://api.tracklysms.com/api/v2/audiences/664f1a2b3c4d5e6f7a8b9c0d/size" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "audience_id": "664f1a2b3c4d5e6f7a8b9c0d",
  "size": 12480,
  "calculated_at": "2025-11-20T10:30:45"
}

​
Error Codes

HTTP StatusError CodeDescription
401unauthorizedAPI key is missing or invalid
404not_foundNo audience exists with the specified ID

​
Next Steps

Creating Audiences

Build and size audiences

Create Schedule

Schedule a campaign to your audience