Skip to main content
GET
/
events
List Api Events
curl --request GET \
  --url https://api.moda.app/v1/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "operation_id": "<string>",
      "endpoint": "<string>",
      "trigger_source": "<string>",
      "status_code": 123,
      "duration_ms": 123,
      "api_key": {
        "id": "<string>",
        "name": "<string>",
        "created_by_name": "<string>"
      },
      "error_code": "<string>",
      "error_message": "<string>",
      "credits_charged": 123,
      "prompt_preview": "<string>",
      "resource": {
        "id": "<string>",
        "type": "<string>",
        "canvas_id": "<string>",
        "canvas_name": "<string>",
        "canvas_url": "<string>"
      }
    }
  ],
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.moda.app/llms.txt

Use this file to discover all available pages before exploring further.

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.