Applied LabsDocs
Conversations

Count conversations

Count how many conversations match your filters before loading the full list.

GET/v2026-04/conversations/count/

Usage

Start from this cURL example and add filters as needed.

cURL
curl -X GET https://core.appliedlabs.ai/v2026-04/conversations/count/ \
  -H "Authorization: Bearer <api-token>" \
  -H "X-Shop-Id: 66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10"

Authorizations

Authorizationstringheaderrequired

Send your Applied API key as Authorization: Bearer AL.... Create the key in the Applied dashboard and keep it on your server.

Query parameters

agent_idstring · uuid

Only return conversations assigned to this agent.

contact_idstring · uuid

Only return conversations for this contact.

contact_id__inarray

Only return conversations for these contacts. Separate values with commas.

created_at__rangestring

Only return records created during this time window. Use 'relative:-7d,' for the last 7 days, or '2026-04-01T00:00:00Z,2026-04-07T23:59:59Z' for a custom start and end time. The maximum window is 30 days.

idstring · uuid

Only return this conversation.

id__inarray

Only return conversations with these IDs. Separate values with commas.

resolutionstring

Only return conversations with this resolution.

resolution__inarray

Only return conversations with these resolutions. Separate values with commas.

Header parameters

X-Shop-Idstring · uuidrequired

The shop whose data you want to read.

Response

How many conversations matched your filters.

countintegerrequired

How many records matched your request.

{
  "count": 42
}