Returns the ticket's conversation — yours and ours — merged across its parent chain.

GET

/v1/integration/tickets/{id}/messages

curl --request GET \
  --url https://api.example.com/v1/integration/tickets/1/messages

• Placeholder: replace with the API address of your own installation.

Oldest first. Pass afterId with the highest id you have already stored to poll incrementally. A ticket that continued in a child returns the whole chain, each entry tagged with the ticketId and trackingKey it belongs to. Every ticket in that chain is checked against your token’s pool scope, not just the one you addressed: an ancestor that has since been moved to a pool your token cannot see is left out entirely.

Parameters

Path Parameters

id

required

integer format: int64

/^-?(?:0|[1-9]\d*)$/

Query Parameters

afterId

integer format: int64

/^-?(?:0|[1-9]\d*)$/

Responses

200

OK

object

data

Array<object>

nullable

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

direction

required

string

channel

required

string

subject

required

string

content

required

string

contentHtml

string

nullable

isContentTruncated

required

boolean

occurredAt

required

string format: date-time

attachments

required

Array<object>

object

id

required

/^-?(?:0|[1-9]\d*)$/

fileName

required

string

contentType

required

string

sizeBytes

required

/^-?(?:0|[1-9]\d*)$/

downloadUrl

required

string

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

object

data

Array<object>

nullable

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

direction

required

string

channel

required

string

subject

required

string

content

required

string

contentHtml

string

nullable

isContentTruncated

required

boolean

occurredAt

required

string format: date-time

attachments

required

Array<object>

object

id

required

/^-?(?:0|[1-9]\d*)$/

fileName

required

string

contentType

required

string

sizeBytes

required

/^-?(?:0|[1-9]\d*)$/

downloadUrl

required

string

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": [
    {
      "id": "example",
      "ticketId": "example",
      "trackingKey": "example",
      "direction": "example",
      "channel": "example",
      "subject": "example",
      "content": "example",
      "contentHtml": "example",
      "isContentTruncated": true,
      "occurredAt": "2026-04-15T12:00:00Z",
      "attachments": [
        {
          "id": "example",
          "fileName": "example",
          "contentType": "example",
          "sizeBytes": "example",
          "downloadUrl": "example"
        }
      ]
    }
  ],
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

object

data

Array<object>

nullable

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

direction

required

string

channel

required

string

subject

required

string

content

required

string

contentHtml

string

nullable

isContentTruncated

required

boolean

occurredAt

required

string format: date-time

attachments

required

Array<object>

object

id

required

/^-?(?:0|[1-9]\d*)$/

fileName

required

string

contentType

required

string

sizeBytes

required

/^-?(?:0|[1-9]\d*)$/

downloadUrl

required

string

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": [
    {
      "id": "example",
      "ticketId": "example",
      "trackingKey": "example",
      "direction": "example",
      "channel": "example",
      "subject": "example",
      "content": "example",
      "contentHtml": "example",
      "isContentTruncated": true,
      "occurredAt": "2026-04-15T12:00:00Z",
      "attachments": [
        {
          "id": "example",
          "fileName": "example",
          "contentType": "example",
          "sizeBytes": "example",
          "downloadUrl": "example"
        }
      ]
    }
  ],
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

404

Not Found

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}