Events

List Events

Changed on

List events with optional filters.

get/events

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /events
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /authorize, token URL /oauth/token)

Query parameters

event_typestring[] nullable

Only return events of one of these types; repeat the parameter for several.

[
  "import.completed"
]
severityEventSeverity[] nullable

Only return events with one of these severities; repeat the parameter for several.

[
  "warning",
  "error"
]
requires_actionboolean nullable

Only return events whose requires_action flag matches.

Example:true
fromstring date-time nullable

Only return events created at or after this time (RFC 3339).

Example:2026-01-01T00:00:00Z
tostring date-time nullable

Only return events created before this time (RFC 3339).

Example:2026-01-31T23:59:59Z
trace_idstring nullable

Only return events with this trace ID.

Example:4bf92f3577b34da6a3ce929d0e0e4736
actor_idstring nullable

Only return events caused by this actor.

Example:agnt_6968b3984d1c238dbe7e2e29
actor_typestring nullable

Only return events caused by this kind of actor, e.g. user or agent.

Example:agent
cursorstring nullable

Opaque cursor from a previous page's next_cursor; omit for the first page.

Example:eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0=
limitinteger

Maximum number of events to return (1-100, default 25).

Example:25

Response

Successful Response

has_moreboolean required

Whether more results exist after this page.

next_cursorstring nullable

Cursor for the next page; null when there are no more results.

Example response

{
  "data": [
    {
      "_links": {
        "action": "https://jentic.example.com/events/evt_6968b398b04f002b6dbff4d1/action",
        "execution": "https://jentic.example.com/executions/exec_6968b3982706c619fe73f0cf",
        "job": "https://jentic.example.com/jobs/job_6968b3985e8c9902207afaeb",
        "self": "https://jentic.example.com/events/evt_6968b398b04f002b6dbff4d1"
      },
      "actor_id": "usr_6968b3987ee4c3ec0b4ee3b9",
      "actor_type": "user",
      "created_at": "2026-01-15T09:30:00Z",
      "data": {
        "job_id": "job_6968b3985e8c9902207afaeb",
        "revision_id": "3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"
      },
      "detail": "The import produced 1 revision with 142 operations.",
      "event_id": "evt_6968b398b04f002b6dbff4d1",
      "requires_action": false,
      "severity": "info",
      "summary": "Imported stripe.com/stripe 2024-04-10",
      "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
      "type": "import.completed"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0="
}

Changes

  • c516481e6ed8Revision changes
    • info

      the endpoint scheme security OAuth2 was added to the API

  • 042bda54be80Revision changes
    • breaking

      removed the required property // from the response with the status

    • warning

      deleted the query request parameter acknowledged

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status