Events

Get an event histogram

GET/v1/events/histogram

Counts of ok and failed events in time buckets, with the same filters as List events.

Parameters

Query parameters1

range?string

Time window.

Returns

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

GETGet an event histogram

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

const res = await fetch("https://api.getensue.com/v1/events/histogram", {
  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/histogram",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

{
  "range": "24h",
  "buckets": [
    {
      "a": 1762761600000,
      "w": 3600000,
      "ok": 120,
      "bad": 2
    }
  ]
}

{"range":"24h","buckets":[{"a":1762761600000,"w":3600000,"ok":120,"bad":2}]}