logo
TicketsList messages (timeline)

List messages (timeline)

Returns email and internal_note rows, oldest first (same as in-app ticket timeline). Draft outbound messages are omitted. Optional types filters by comma-separated email and/or internal_note (default: both).

curl -X GET "/api/v1/tickets/example_string/messages?types=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (API key (ixk_...))"
{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "direction": "inbound",
      "type": "email",
      "from_address": "123 Main St",
      "to_addresses": "123 Main St",
      "cc_addresses": "123 Main St",
      "bcc_addresses": "123 Main St",
      "send_status": "pending",
      "send_error": "example_string",
      "body_text": "example_string",
      "body_html": "example_string",
      "sent_at": "2024-12-25T10:00:00Z",
      "created_at": "2024-12-25T10:00:00Z",
      "attachments": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "file_name": "John Doe",
          "content_type": "example_string",
          "size_bytes": 42,
          "disposition": "attachment",
          "content_id": "example_string"
        }
      ]
    }
  ]
}
GET
/tickets/{id}/messages
GET
Bearer Token (API key (ixk_...))
Bearer Tokenstring
Required

API key from Settings → API. Pass as Authorization: Bearer <key>

API key from Settings → API. Pass as Authorization: Bearer <key>
path
idstring
Required

Ticket UUID or ticket_number

query
typesstring

Comma-separated: email, internal_note

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (API key (ixk_...)). API key from Settings → API. Pass as Authorization: Bearer <key>

Path Parameters

idstring
Required

Ticket UUID or ticket_number

Query Parameters

typesstring

Comma-separated: email, internal_note

Responses

dataarray