Sign in

v51

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2026-08-011534301009.2 KB
Events

List ingested events

List ingested events within a time range.

If the from query param is not provided it defaults to last 72 hours.

get/api/v1/events

Query parameters

clientIdstring

Client ID Useful to track progress of a query.

ingestedAtFromstring date-time

Start date-time in RFC 3339 format.

Inclusive.

ingestedAtTostring date-time

End date-time in RFC 3339 format.

Inclusive.

idstring

The event ID.

Accepts partial ID.

subjectstring

The event subject.

Accepts partial subject.

customerIdstring[]

The event customer ID.

[
  "01G65Z755AFWAKHE12NY0CQ9FH"
]
fromstring date-time

Start date-time in RFC 3339 format.

Inclusive.

tostring date-time

End date-time in RFC 3339 format.

Inclusive.

limitinteger

Number of events to return.

Response

The request has succeeded.

customerIdstring

The customer ID if the event is associated with a customer.

validationErrorstring

The validation error if the event failed validation.

ingestedAtstring date-time required

The date and time the event was ingested.

storedAtstring date-time required

The date and time the event was stored.

Example response

[
  {
    "event": {
      "id": "5c10fade-1c9e-4d6c-8275-c52c36731d3c",
      "source": "service-name",
      "specversion": "1.0",
      "type": "prompt",
      "subject": "customer-id",
      "time": "2023-01-01T01:01:01.001Z"
    },
    "ingestedAt": "2023-01-01T01:01:01.001Z",
    "storedAt": "2023-01-01T01:01:02.001Z"
  }
]