List a conversation's messages

Every message on one thread, oldest first, up to 100. Drafts and blocked messages appear with their status.

GEThttps://app.trygtm.com/api/v1/conversations/{conversation_id}/messages
Scope
read

Path parameters

conversation_idstringrequired
The conversation's id. A message's, queued step's or contact's id is read as its conversation.

Request

curl https://app.trygtm.com/api/v1/conversations/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/messages \
  -H "Authorization: Bearer $TRYGTM_API_KEY"

Response

{
  "data": [
    {
      "id": "9f8e7d6c-5b4a-4392-8180-7f6e5d4c3b2a",
      "conversation_id": "0f1e2d3c-4b5a-4697-8877-665544332211",
      "direction": "inbound",
      "channel": "email",
      "kind": "message",
      "status": "delivered",
      "subject": "Re: routing software",
      "body": "Could you do Tuesday?",
      "gate_result": null,
      "error": null,
      "created_at": "2026-09-18T10:15:00.000Z",
      "updated_at": "2026-09-18T10:15:00.000Z",
      "sent_at": null,
      "delivered_at": null
    }
  ]
}

Was this page helpful?