API ReferenceEvents

Get Events

Lists audit events for the caller's organization. Results are paginated. If more events are available, the response includes `pagination.next_page_token`; pass that token back unchanged to continue from the last item you received. Filter by event type using the `event_type` query parameter. Pass one of the identifiers returned by [`GET /api/events_types`](../../api-reference/events/get-types) to narrow results to a specific category of activity. > 📘 Events reflect audit activity scoped to the caller's organization. > The log captures both user-initiated and API-initiated actions.

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

OR
AuthorizationBearer
This is the Polytomic API key

Headers

X-Polytomic-VersionstringRequired

Query parameters

organization_idstringOptionalformat: "uuid"

Organization to list events for. Only used by system callers; normal and partner callers are always scoped to their own organization.

typestringOptional

Filter to a single event type. Use GET /api/events_types to list valid values.

starting_afterstringOptionalformat: "date-time"
Return events created strictly after this timestamp.
ending_beforestringOptionalformat: "date-time"
Return events created strictly before this timestamp.
limitintegerOptional1-100Defaults to 10
Maximum number of events to return. Default 10, maximum 100.

Response

OK
datalist of objects or null

Errors

401
Unauthorized Error
422
Unprocessable Entity Error
500
Internal Server Error