Skip to main content
GET
List appointments

Authorizations

Authorization
string
header
required

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

Query Parameters

workspace_id
string
required

Workspace to query.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

limit
integer

Page size. Defaults to 20. Max 100.

Required range: 1 <= x <= 100
cursor
string

Pagination cursor returned as next_cursor on the previous page.

order
enum<string>

Sort direction over scheduled start time. Defaults to desc (most recently scheduled first).

Available options:
asc,
desc
status
enum<string>

Filter by appointment status. Use completed, no_show, cancelled, or rescheduled to compute booking efficacy rates.

Available options:
awaiting_response,
awaiting_confirmation,
confirmed,
cancelled,
completed,
no_show,
rescheduled
start_after
string<date-time>

Only return appointments scheduled at or after this ISO 8601 timestamp.

Example:

"2026-04-01T00:00:00.000Z"

start_before
string<date-time>

Only return appointments scheduled strictly before this ISO 8601 timestamp.

Example:

"2026-05-01T00:00:00.000Z"

Response

Appointments

Cursor-paginated appointments response.

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