Skip to content
Dashboard
Theme
Theme

Retrieve an audit log export

GET /v1/audit_logs/exports/{export}: Retrieve an audit log export.

View Markdown

GET /v1/audit_logs/exports/{export}

The export’s state and, once ready and until it expires (24 hours after completion), a download URL. The URL is signed for each request and valid for at most 15 minutes (expires_at is the URL’s expiry); retrieve the export again for a fresh one. bundles lists the export’s files (one, or one per organization when an environment export exceeds the bundle limits), each signed the same way. Another environment’s export is not found.

Scope
audit:read
Auth
Secret key (sk_…)
Since
1.0
  • export string Required

  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

Errors share one shape; see the error code catalogue.

curl -X GET \
"https://api.ohauthcat.com/v1/audit_logs/exports/aexp_01J9Z3K5V7W8X9Y0Z1A2B3C4D5" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY"
Response 200
{
"id": "aexp_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"object": "audit_log_export",
"state": "pending",
"url": "https://app.acme.com/callback",
"expires_at": "2026-01-15T09:30:00Z"
}