Manual
CLI
API
Log in Get started free

Export the audit log

Downloads every audit log entry that matches the filters, as CSV or JSON.

Downloads the audit log as a file, newest entry first.

HTTP
GET /org/audit/export

Access: Session token only. API keys get 403 with insufficient_scope.

Role: Organisation owner or admin.

Query parameters #

All are optional. The filters are the same as for the audit log: action, user, from and to.

ParameterTypeDescription
formatstringcsv (the default) or json.

The export holds at most 50,000 entries. Narrow it with from and to if you have more.

Response 200 #

A file, sent as an attachment.

  • csv: Content-Type: text/csv, with the header id,time,person,email,action,description,ip,user_agent. A cell that starts with =, +, - or @ gets a leading ', so a spreadsheet does not run it as a formula.
  • json: the same list of entries as the audit log.

Errors #

StatuserrorWhen
401unauthenticatedThe token is missing or not valid.
403forbiddenYou are not an owner or admin.
422invalid_requestA query parameter is not valid. fields names it.
429rate_limitedToo many requests, see Rate limiting.

See Errors for the error format.

Notes #

Every export is recorded in the audit log as audit.exported, after the entries were read, so the export does not contain its own entry.