Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Query Parameters

after
string

A response ID to use as a cursor for pagination. Returns responses that come after this ID in the list. Used for cursor-based pagination to fetch subsequent pages.

Example:

"resp_abc123"

before
string

A response ID to use as a cursor for pagination. Returns responses that come before this ID in the list. Used for cursor-based pagination to fetch previous pages.

Example:

"resp_xyz789"

limit
integer
default:20

The maximum number of responses to return per page. Must be between 1 and 100. Defaults to 20 items.

Required range: 1 <= x <= 100
Example:

25

order
enum<string>
default:desc

The order to return the responses in by creation date. 'asc' returns oldest responses first, 'desc' returns newest responses first. Defaults to 'desc' (newest first).

Available options:
asc,
desc
Example:

"desc"

Response

200 - application/json

Paginated list of responses for the authenticated user.

Paginated list object containing responses with cursor-based pagination metadata.

object
any
required

The object type, always 'list' for paginated list responses.

data
object[]
required

Array of response objects. Each response contains its status, model, input/output, tool usage logs, metadata, and completion information.

has_more
boolean
required

Indicates whether there are more responses available beyond the current page. True if additional pages exist, false otherwise.

first_id
string

The ID of the first response in the current page. Used as a reference point for pagination.

last_id
string

The ID of the last response in the current page. Used as a cursor for fetching the next page.