Applied LabsDocs
Conversations

Get conversation

Retrieve a single conversation by ID.

GET/v2026-04/conversations/{id}/

Usage

Start from this cURL example and add filters as needed.

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

Path parameters

idstring · uuidrequired

The ID of the conversation you want to retrieve.

Header parameters

X-Shop-Idstring · uuidrequired

The shop whose data you want to read.

Response

The conversation you asked for.

agent_idstring · uuid | nullrequired
contact_idstring · uuid | nullrequired
created_atstring · date-timerequired
directionenum<string>

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

inboundoutbound
flagsarrayrequired

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

flags.idstring · uuidrequired
flags.namestringrequired
idstring · uuidrequired
intentallOfrequired

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

intent.option1object
is_testboolean
remote_idstring | null
remote_platformstring | null
resolutiononeOf

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

hardsoftescalatedhumanmerged
statusoneOf

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

newopenpending
tagsarrayrequired

Free-form tags applied to the conversation.

tags[]string
titlestring
topicallOfrequired

Topic the conversation is categorized under, if any.

topic.option1object
typeenum<string>required

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

phone_callweb_callweb_call_demovideo_callweb_chatemailsmscommentsform
updated_atstring · date-timerequired
user_idstring · uuid | nullrequired
{
  "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"
}