Saltar al contenido principal
GET
Returns the messages of a conversation thread, oldest first by default. Narrow it to one conversation with session_id (the id from List Conversations) or to a time window with from and to.

Headers

string
requerido
Your API key for authentication. An organization key reads any thread of the organization. A personal key needs the messages.read permission and reads only the threads its user can see in the inbox.

Path Parameters

string
requerido
The UUID of the thread.

Query Parameters

string
UUID of a conversation of this thread: only its messages are returned. Messages from before conversations were tracked have no session_id and are left out by this filter.
string
Only messages created at or after this instant (ISO 8601, e.g. 2026-11-10T00:00:00-05:00).
string
Only messages created before this instant (ISO 8601). It cannot be before from.
string
predeterminado:"asc"
Sort direction by creation date: asc (oldest first) or desc.
number
predeterminado:"50"
Messages per page, from 1 to 100.
number
predeterminado:"0"
Number of messages to skip for pagination, up to 10000.

Response

array
Messages of the page.
object

Error Codes

  • 400 Bad Request — threadId or session_id is not a UUID, a date is not ISO 8601, or to is before from
  • 401 Unauthorized — Invalid or missing API key
  • 403 Forbidden — The thread belongs to another organization, or the personal key’s user cannot see it
  • 404 Not Found — Thread not found
  • 429 Too Many Requests — Rate limit exceeded, see Rate limits
  • 500 Internal Server Error — Server-side error

Code Examples