v1

latestOpenAPI 3.1.02026-07-26497885.9 KB

List audit logs

Retrieve a paginated, time-scoped list of audit log events for an organization. Requires an Enterprise plan with the audit logs entitlement enabled.

get/organizations/{organization_id}/audit_logs

Path parameters

organization_idstring required

The UUID of the organization to retrieve audit logs for. Must match the authenticated Organization API Key.

Query parameters

start_timestring

Start of the time range in ISO 8601 format (e.g. 2026-02-01T00:00:00Z). Required unless cursor is provided. Must be within the last 90 days and no earlier than 2026-02-18T00:00:00Z.

end_timestring

End of the time range in ISO 8601 format. Defaults to the current time. Must be after start_time.

cursorstring

Pagination cursor returned in a previous response as next_cursor. When provided, start_time and end_time are ignored.

limitinteger

Maximum number of events to return per page. Minimum 1, maximum 100. Values outside this range are clamped automatically.

app_idsstring[]

Filter events by app UUID. Accepts up to 10 values. Org-level events are always included. Repeat the parameter for multiple values: app_ids=uuid1&app_ids=uuid2.

actionsstring[]

Filter by action type (e.g. notification.sent, segment.created). Accepts up to 20 values. Repeat the parameter for multiple values: actions=notification.sent&actions=segment.created.

actor_idsstring[]

Filter by actor UUID (the user or service that performed the action). Accepts up to 10 values. Repeat the parameter for multiple values: actor_ids=uuid1&actor_ids=uuid2.

actor_emailsstring[]

Filter by actor email address. Accepts up to 10 values. Repeat the parameter for multiple values: actor_emails=a@example.com&actor_emails=b@example.com.

target_typesstring[]

Filter by the type of resource the action was performed on (e.g. notification, segment, journey). Accepts up to 10 values. Repeat the parameter for multiple values: target_types=notification&target_types=segment.

target_idsstring[]

Filter by the UUID of the resource the action was performed on. Accepts up to 10 values. Repeat the parameter for multiple values: target_ids=uuid1&target_ids=uuid2.

ip_addressesstring[]

Filter by the IP address the action originated from. Accepts up to 10 values. Repeat the parameter for multiple values: ip_addresses=203.0.113.1&ip_addresses=203.0.113.2.

Headers

Authorizationstring required

Your Organization API key with prefix Key . See Keys & IDs.

Response

200

has_moreboolean

true if additional events exist beyond this page. Use next_cursor to fetch the next page.

next_cursorstring

Opaque cursor to pass as cursor in the next request. Only present when has_more is true.