Filter events using a Base64-encoded JSON object.

The filters query parameter is required.

Choose the fields below, serialize the object to JSON, and Base64-encode the UTF-8 bytes. Enter the encoded value in the filters input. These fields belong inside the JSON object; they are not separate query parameters.

Decoded filter fields

Example before encoding

{
  "timeRange": {
    "start": "2024-06-30T01:00:00.000Z",
    "end": "2024-07-30T23:59:00.000Z"
  }
}

Base64 value for the filters input

eyJ0aW1lUmFuZ2UiOnsic3RhcnQiOiIyMDI0LTA2LTMwVDAxOjAwOjAwLjAwMFoiLCJlbmQiOiIyMDI0LTA3LTMwVDIzOjU5OjAwLjAwMFoifX0=

Example request

/events?filters=eyJ0aW1lUmFuZ2UiOnsic3RhcnQiOiIyMDI0LTA2LTMwVDAxOjAwOjAwLjAwMFoiLCJlbmQiOiIyMDI0LTA3LTMwVDIzOjU5OjAwLjAwMFoifX0%3D

Encode inline in Node.js

const criteria = {"timeRange":{"start":"2024-06-30T01:00:00.000Z","end":"2024-07-30T23:59:00.000Z"}};
const params = new URLSearchParams({
  filters: Buffer.from(JSON.stringify(criteria), "utf8").toString("base64")
});
const path = "/events?" + params.toString();

Base64 encoding and URL encoding are separate steps. An HTTP client query-parameter helper can URL-encode the Base64 value for you. If constructing the URL manually, URL-encode the value once so +, /, and = are preserved.