Maton

List Events

GET/triggers/{trigger_id}/events

Authorization

bearerAuth
AuthorizationBearer <token>

Your Maton API key, sent as Authorization: Bearer <MATON_API_KEY>. Create one at https://maton.ai/settings.

In: header

Path Parameters

trigger_id*string

The trigger's unique identifier.

Query Parameters

limit?integer

Maximum number of items to return.

next_token?string

Opaque pagination cursor from the previous response. Omit for the first page; absent/null in the response means the last page.

since_id?string

Return only events received after this event ID (exclusive).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET \  "https://api.maton.ai/triggers/{trigger_id}/events?limit=20" \  -H "Authorization: Bearer $MATON_API_KEY"
{
  "events": [
    {
      "event_id": "e7f8a9b0-c1d2-4e3f-8a4b-5c6d7e8f9a0b",
      "received_at": "2026-06-20T16:00:09.938161Z",
      "payload": {
        "scheduled_for": "2026-06-20T16:00:00Z",
        "cron_expression": "0 9 * * *",
        "timezone": "America/Los_Angeles"
      },
      "delivery_counts": {
        "total": 1,
        "succeeded": 1,
        "failed": 0
      }
    }
  ],
  "next_token": "gAAAAABqN6Xf...="
}
{
  "message": "Invalid app name.",
  "type": "Bad Request",
  "code": 400
}
{
  "message": "Invalid API key.",
  "type": "Unauthorized",
  "code": 401
}
{
  "message": "Resource not found.",
  "type": "Not Found",
  "code": 404
}
{
  "message": "Too many requests.",
  "type": "Too Many Requests",
  "code": 429
}
{
  "message": "Internal server error.",
  "type": "Internal Server Error",
  "code": 500
}