Applied LabsDocs
Conversations

List conversations

Retrieve conversations from your Applied workspace. Results are shown newest first, and you can narrow them by conversation, contact, assigned agent, resolution, or created date.

GET/v2026-04/conversations/

Usage

Start from this cURL example and add filters as needed.

cURL
curl -X GET https://core.appliedlabs.ai/v2026-04/conversations/ \
  -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.

cursorstring

Use the cursor from a previous next or previous link to move through the results.

idstring · uuid

Only return this conversation.

id__inarray

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

limitinteger

How many results to return in this page.

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

A page of conversations.

nextstring · uri | null
previousstring · uri | null
resultsarrayrequired
results.agent_idstring · uuid | nullrequired
results.contact_idstring · uuid | nullrequired
results.created_atstring · date-timerequired
results.directionenum<string>

Whether the conversation started with an incoming customer message or an outbound message from your team.

inboundoutbound
results.idstring · uuidrequired
results.is_testboolean
results.remote_idstring | null
results.remote_platformstring | null
results.resolutiononeOf

How the conversation was resolved, when a resolution is available.

hardsoftescalatedhumanmerged
results.statusoneOf

Whether the conversation is new, open, or waiting on the next reply.

newopenpending
results.titlestring
results.typeenum<string>required

Which channel the conversation came from, such as email, chat, SMS, or voice.

phone_callweb_callweb_call_demoweb_chatemailsmscommentsform
results.updated_atstring · date-timerequired
results.user_idstring · uuid | nullrequired
{
  "next": "https://core.appliedlabs.ai/v2026-04/conversations/?cursor=next-cursor-token",
  "previous": "https://core.appliedlabs.ai/v2026-04/conversations/?cursor=previous-cursor-token",
  "results": [
    {
      "agent_id": "33333333-3333-4333-8333-333333333333",
      "contact_id": "11111111-1111-4111-8111-111111111111",
      "created_at": "2026-04-07T14:30:00Z",
      "direction": "inbound",
      "id": "55555555-5555-4555-8555-555555555555",
      "is_test": false,
      "remote_id": "conv_3706spyi",
      "remote_platform": "zendesk",
      "resolution": "escalated",
      "status": "open",
      "title": "Nor rest four imagine difficult treatment for invoice follow-up",
      "type": "email",
      "updated_at": "2026-04-07T15:12:00Z",
      "user_id": "44444444-4444-4444-8444-444444444444"
    }
  ]
}