Skip to main content
GET
List conversations

Authorizations

Authorization
string
header
required

A Custral secret API key (sk_…), created in Settings → Applications. Sent as Authorization: Bearer sk_…. The X-Api-Key: sk_… header is also accepted and takes precedence. Never expose a secret key in a browser.

Query Parameters

limit
integer
default:50

How many to return (1–200).

offset
integer
default:0

How many to skip.

status
enum<string>

Filter by lifecycle status.

Available options:
open,
closed,
completed
channelId
string

Filter to a single channel (chan_…).

Response

A page of conversations.

data
object

A page of conversations.

reqId
string

A per-request id (req_…). Quote it to support when reporting a problem.

Example:

"req_2a1f9c8e7b6d5"