Skip to main content
GET
List Api Events

Authorizations

Authorization
string
header
required

API key from Settings > Developer > REST API

Headers

Moda-Version
enum<string>
default:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Available options:
2026-04-12,
2026-05-01
Example:

"2026-05-01"

Query Parameters

api_key_id
string | null

Optional API-key UUID filter.

operation_id
string | null

Optional exact-match filter on the event's OpenAPI operationId.

trigger_source
enum<string> | null

Restrict to api or mcp origin rows.

Available options:
api,
mcp
status
enum<string> | null

succeeded → 200-399; failed → status >= 400.

Available options:
succeeded,
failed
from
string<date-time> | null

ISO8601 UTC lower bound (inclusive). Defaults to to - 7d.

to
string<date-time> | null

ISO8601 UTC upper bound (exclusive). Defaults to now.

limit
integer
default:50

Max rows per page (cap: 200).

Required range: 1 <= x <= 200
cursor
string | null

Opaque cursor from the previous page's next_cursor.

Response

Successful Response

data
EventResponse · object[]
required

Items in this page, in the endpoint's declared sort order.

next_cursor
string | null

Opaque cursor to pass as ?cursor= on the next request. null means you've reached the end of the collection.

returned
integer
default:0

Number of items in this page (always len(data); derived server-side).

has_more
boolean
default:false

true when more items exist beyond this page — keep requesting with next_cursor until this is false. Never trust len(data) < limit alone.

limit
integer | null

The effective page-size limit this response was computed with.

total
integer | null

True total number of items in the collection (after filters), when the endpoint can count cheaply. null on log/search lanes — use has_more there.