Applied LabsDocs
Conversations

Export conversations

Export conversations with their messages inlined. Results are shown oldest first for stable backfills. Use date windows and the cursor links to export larger ranges safely.

GET/v2026-04/conversations/export/

Rate limits

  • 60 requests/minute per API token and shop. Each page can include up to 100 conversations.

Usage

Start from this cURL example and add filters as needed.

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

last_message_at__rangestring

Only return conversations with recent message activity 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.

limitinteger

How many conversations to return in this page. The maximum is 100.

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 with messages inlined.

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 record is incoming or outbound.

inboundoutbound
results.escalation_timestring · date-time | null
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.last_message_atstring · date-time | null
results.last_message_contentstring
results.messagesarrayrequired

Messages in this conversation, ordered from oldest to newest.

results.remote_idstring | null
results.remote_platformstring | null
results.resolutiononeOf
hardsoftescalatedhumanmerged
results.resolved_atstring · date-time | null
results.start_timestring · date-time | null
results.statusoneOf

Escalation status tracking whether the thread waits on a human agent or the end customer.

newopenpending
results.summarystring
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

How the conversation started, such as email, web 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/export/?cursor=next-cursor-token",
  "previous": "https://core.appliedlabs.ai/v2026-04/conversations/export/?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",
      "escalation_time": "2026-04-07T15:12:00Z",
      "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,
      "last_message_at": "2026-04-07T15:12:00Z",
      "last_message_content": "A billing teammate will follow up shortly.",
      "messages": [
        {
          "agent_id": "33333333-3333-4333-8333-333333333333",
          "contact_id": "11111111-1111-4111-8111-111111111111",
          "contact_remote_id": "cus_3667beus",
          "content": "Participant individual American range attorney role.",
          "conversation_id": "55555555-5555-4555-8555-555555555555",
          "created_at": "2026-04-07T14:30:00Z",
          "format": "TEXT",
          "id": "66666666-6666-4666-8666-666666666666",
          "remote_id": "msg_0426mwfo",
          "remote_platform": "zendesk",
          "role": "assistant",
          "status": "DELIVERED",
          "text": "Participant individual American range attorney role.",
          "ticket_id": "77777777-7777-4777-8777-777777777777",
          "type": "External",
          "updated_at": "2026-04-07T15:12:00Z",
          "user_id": "44444444-4444-4444-8444-444444444444"
        }
      ],
      "remote_id": "conv_3706spyi",
      "remote_platform": "zendesk",
      "resolution": "escalated",
      "resolved_at": null,
      "start_time": "2026-04-07T14:30:00Z",
      "status": "open",
      "summary": "Customer asked about an invoice and was escalated to billing.",
      "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"
    }
  ]
}