Skip to main content
GET
Returns conversation history for a project with pagination and optional filters.

Authentication

X-API-Key
string
required
Project API key for this organization and project. Format: bot_live_…

Path parameters

organization_id
string
required
Organization ID. Must match the API key.
project_id
string
required
Project ID. Must match the API key.

Query parameters

skip
integer
default:"0"
Number of records to skip.
limit
integer
default:"20"
Page size. Range: 1100.
filters
string
JSON filter object, for example {"status":"completed"}.
sort
string
JSON sort object, for example {"start_time":-1}.
unique
boolean
default:"false"
When true, returns only the latest conversation per unique caller.

Response

items
array
required
Conversation records for the current page.
pagination
object
required
Pagination metadata (total, page, page_size, total_pages, has_next, has_prev).

Errors

401
Unauthorized
Missing, invalid, or revoked API key.
403
Forbidden
API key is not authorized for this organization or project.