Messages

List messages

Retrieve messages across your Applied conversations and tickets. Use filters to focus on a specific conversation or ticket.

GET/v2026-04/messages/

Usage

Start from this cURL example and add filters as needed.

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

conversation_idstring · uuid

Only return messages from this conversation.

conversation_id__inarray

Only return messages from these conversations. Separate values with commas.

cursorstring

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

limitinteger

How many results to return in this page.

ticket_idstring · uuid

Only return messages linked to this ticket.

Header parameters

X-Shop-Idstring · uuidrequired

The shop whose data you want to read.

Response

A page of messages.

nextstring · uri | null
previousstring · uri | null
resultsarrayrequired
results.agent_idstring · uuid | nullrequired
results.contact_idstring · uuid | nullrequired
results.contentstring
results.conversation_idstring · uuid | nullrequired
results.created_atstring · date-time
results.formatenum<string>

How the message content is formatted.

TEXTRICH_TEXTHTMLMARKDOWN
results.idstring · uuidrequired
results.remote_idstring | null
results.remote_platformstring | null
results.rolestring
results.statusoneOf

Delivery status for outbound messages.

PENDINGDELIVEREDFAILEDHIDDEN
results.textstring
results.ticket_idstring · uuid | nullrequired
results.typeenum<string>

Whether the message is customer-facing or internal only.

InternalExternal
results.updated_atstring · date-timerequired
results.user_idstring · uuid | nullrequired
{
  "next": "https://core.appliedlabs.ai/v2026-04/messages/?cursor=next-cursor-token",
  "previous": "https://core.appliedlabs.ai/v2026-04/messages/?cursor=previous-cursor-token",
  "results": [
    {
      "agent_id": "33333333-3333-4333-8333-333333333333",
      "contact_id": "11111111-1111-4111-8111-111111111111",
      "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_3667beus",
      "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"
    }
  ]
}