audit-logs

Pull Audit Logs

Pull your organization's audit events for ingestion into a SIEM or archive. Events are returned oldest-first as newline-delimited JSON (application/x-ndjson) by default, or as CSV with the same columns as the Settings → Organization → Audit Logs download.

Results are always scoped to the organization the credential belongs to. Pagination is cursor-based: when more events match, the response carries an X-Next-Cursor header — pass it as cursor on the next request and keep the same since/until window.

Reading the trail is itself an audited event: every pull records an audit.pulled event for the calling organization before the body is served, deduplicated to one event per credential per UTC day. If that event cannot be recorded the request fails with 500 and returns no events — retry the same request.

get/v2/audit-logs

Query parameters

sincestring date-time nullable

Inclusive lower bound on the event timestamp (ISO-8601 UTC, e.g. 2026-07-01T00:00:00Z). Omit to start from the oldest retained event.

Inclusive lower bound on the event timestamp (ISO-8601 UTC, e.g. 2026-07-01T00:00:00Z). Omit to start from the oldest retained event.

untilstring date-time nullable

Exclusive upper bound on the event timestamp (ISO-8601 UTC).

Exclusive upper bound on the event timestamp (ISO-8601 UTC).

cursorstring nullable

Opaque cursor from the X-Next-Cursor header of a prior response.

Opaque cursor from the X-Next-Cursor header of a prior response.

limitinteger

Page size (1–1000). Events are returned oldest-first.

Page size (1–1000). Events are returned oldest-first.

format'jsonl' | 'csv'

Response body format. jsonl (default) is the SIEM primary; csv matches the Settings download columns.

Response body format. jsonl (default) is the SIEM primary; csv matches the Settings download columns.

Response

Successful Response

Changes

No recorded changes to this endpoint across all 1 revision of this API.