Skip to main content
GET
/
conversations
/
{contact_id}
Get Conversation
curl --request GET \
  --url https://api.getoutbox.ai/conversations/{contact_id} \
  --header 'Authorization: <api-key>'
{
  "contact": {
    "id": "<string>",
    "name": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "tags": [
      "<string>"
    ]
  },
  "messages": [
    {
      "type": "message",
      "id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "role": "user",
      "message": "<string>",
      "platform": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "total": 123,
    "has_next": true,
    "has_previous": true
  }
}

Authorizations

Authorization
string
header
required

Company API Key

Headers

X-User-Timezone
string

User's timezone for timestamp formatting (defaults to UTC)

Path Parameters

contact_id
string
required

The ID of the contact

Query Parameters

page
integer
default:1

Page number for pagination. Page size is 10 items.

Response

Conversation history retrieved successfully

contact
object
messages
object[]

Unified conversation history with messages, calls, tool calls, and interrupts

pagination
object