Skip to main content
GET
Get paginated sessions of a conversation

Authorizations

Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Path Parameters

uuid
string<uuid>
required

Query Parameters

page
integer
default:1
per_page
integer
default:15
Required range: x <= 100
status
enum<string>
Available options:
active,
completed,
timed_out
type
enum<string>
Available options:
text,
voice
sort_by
enum<string>
default:started_at
Available options:
created_at,
updated_at,
started_at,
last_activity_at
sort_dir
enum<string>
default:desc
Available options:
asc,
desc

Response

Success

success
boolean

Indicates whether the request completed successfully. True for successful responses; false for documented error responses.

Example:

true

message
string

Human-readable response message. Safe to display in logs or simple client notifications; use structured fields for program logic.

Example:

"Sessions retrieved successfully"

data
object