Events

Get Event

Changed on

Get an event by ID.

get/events/{event_id}

Request

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

Path parameters

event_idstring required

ID of the event.

Example:evt_6968b398b04f002b6dbff4d1

Response

Successful Response

actor_idstring nullable

ID of the actor that caused the event; null if none.

actor_typestring nullable

Kind of actor that caused the event, e.g. user or agent; null if none.

created_atstring date-time required

When the event was created (RFC 3339).

dataobject

Type-specific structured payload; empty object when there is none.

detailstring nullable

Longer human-readable detail; null if none.

event_idstring required

Unique ID of the event (evt_…).

requires_actionboolean required

Whether the event needs someone to act on it.

severity'info' | 'warning' | 'error' | 'critical' required

Severity level for platform events.

summarystring required

Short human-readable summary of the event.

trace_idstring nullable

Trace ID of the request that produced the event, if any.

typestring required

Namespaced event type, e.g. import.completed. Opaque string: historical events may carry types that are no longer emitted.

Example response

{
  "_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"
}

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

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status