Skip to main content
GET
/
v1
/
conversations
/
{id}
/
messages
List messages for conversation
curl --request GET \
  --url https://api.conduit.ai/v1/conversations/{id}/messages \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "yh7t5azsr0zpfpyf67vtce0j6n844y1e",
      "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
      "conversation_id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
      "channel": "unthreaded_email",
      "body": "Hi there, can you confirm check-in time?",
      "direction": "outbound",
      "status": "sent",
      "sent_at": "2026-04-03T03:15:02.000Z",
      "created_at": "2026-04-03T03:15:04.000Z",
      "sender": {
        "user_id": "m48k3v7p2q9x5t1w8r6n4j0y3u2i5o7a",
        "external_id": null,
        "name": "Alex M"
      }
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

​
Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

​
id
string
required

Canonical conversation id.

Example:

"ph77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

​
workspace_id
string

Optional workspace override. If omitted, Conduit resolves the conversation's workspace automatically.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

​
limit
integer
Required range: 1 <= x <= 100
​
cursor
string
​
order
enum<string>
Available options:
asc,
desc

Response

Conversation messages

Cursor-paginated conversation messages response.

​
data
object[]
required
​
next_cursor
string | null
required
​
has_more
boolean
required