Events

List events

GET/v1/events

Newest first. Page with before.

Parameters

Query parameters11

status?string

Repeatable. Filter by event status.

flow?string

Repeatable. Filter by flow ID.

source?string

Source ID.

destination?string

Destination ID.

subscription?string

Subscription ID.

correlation?string

Events whose request carried this correlation value.

delivery_group?string

A delivery group.

kind?string

gateway or dispatch.

range?string

Time window, such as 24h.

before?string

Return events older than this event ID.

limit?integer

1 to 100. Default 50.

Returns

200The sample response is on the right.Errors return error and message; see Errors and limits.

GETList events

curl "https://api.getensue.com/v1/events" \
  -H "authorization: Bearer $ENSUE_API_KEY"

const res = await fetch("https://api.getensue.com/v1/events", {
  method: "GET",
  headers: {
    authorization: `Bearer ${process.env.ENSUE_API_KEY}`,
  },
});
console.log(await res.json());

import os, requests

res = requests.get(
    "https://api.getensue.com/v1/events",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

{
  "items": [
    {
      "id": "evt_…",
      "status": "delivered"
    }
  ],
  "next": "evt_…"
}

{"items":[{"id":"evt_…","status":"delivered"}],"next":"evt_…"}