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.flagsarrayrequired

Review flags applied to the conversation, each with an id and name.

results.idstring · uuidrequired
results.intentallOfrequired

Intent (subcategory of the topic) for the conversation, if any.

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.tagsarrayrequired

Free-form tags applied to the conversation.

results.titlestring
results.topicallOfrequired

Topic the conversation is categorized under, if any.

results.typeenum<string>required

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

phone_callweb_callweb_call_demovideo_callweb_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",
      "flags": [
        {
          "id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
          "name": "Action required"
        }
      ],
      "id": "55555555-5555-4555-8555-555555555555",
      "intent": {
        "id": "99999999-9999-4999-8999-999999999999",
        "name": "Invoice question"
      },
      "is_test": false,
      "remote_id": "conv_3706spyi",
      "remote_platform": "zendesk",
      "resolution": "escalated",
      "status": "open",
      "tags": [
        "vip",
        "billing"
      ],
      "title": "Nor rest four imagine difficult treatment for invoice follow-up",
      "topic": {
        "id": "88888888-8888-4888-8888-888888888888",
        "name": "Billing"
      },
      "type": "email",
      "updated_at": "2026-04-07T15:12:00Z",
      "user_id": "44444444-4444-4444-8444-444444444444"
    }
  ]
}