Skip to main content
GET
Export the deployment's governance decision records
The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.

v2 compatibility notes

Returns one page of resolved governance decisions for the authenticated acting organization in the window, newest first, in one disposition vocabulary (pass, block, hold). Filter by disposition; the legacy allow and hold-for-approval are read as pass and hold. The credential must also hold grants:read, policies:read and audit:read at its acting organization. Current grants are rechecked on each page. Without them the export is 403 permission_denied with a decisionId: the refusal is recorded as an authorization denial, as the recorded-evidence reads do, and if Forge cannot record it the answer is 503 instead. Unresolved, foreign, personal, platform and private-channel decisions are excluded, as are client-reported rows even when includeClientReported=true. Private receipts and proofs are never returned. An empty page can carry a continuation cursor because authorization follows physical pagination. Continue until the cursor is null. A page stopped by the reconciliation budget carries partial: true with saturatedAt: null. A page reads a bounded number of records, so a large window is paged to its end instead of ending early. When more records share one millisecond than a page can read, the page carries partial: true and saturatedAt: the rest of that millisecond is skipped, and cursor continues below it. A cursor issued before this behavior keeps working. See Compliance for who can export.

Example

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

startTime
integer
required

Window start, epoch milliseconds.

endTime
integer
required

Window end, epoch milliseconds; at most 90 days after startTime.

limit
integer
default:100

Records per page, 1 to 1,000. A value above 1,000 is 400 too_big; a value below 1 reads 1.

Required range: 1 <= x <= 1000
cursor
string

The previous page's cursor, unchanged. It is opaque.

disposition
enum<string>

Only records with this disposition. The legacy allow and hold-for-approval are read as pass and hold.

Available options:
pass,
block,
hold,
allow,
hold-for-approval
includeClientReported
enum<string>

Exactly true includes Console-reported denials (a person saw a refusal; not gate evidence). Omitted or any other value leaves them out.

Available options:
true

Response

One page of governance decision records

data
object
required

One page of the deployment's governance decision records, newest first, with one disposition vocabulary (pass, block, hold). Each record is the stored row as written (an open object with a stable id), including principal and person-resource events: the exports are for a deployment-root auditor. Follow cursor until it is null. partial: true with saturatedAt means more records shared that millisecond than one page can read; the rest of that millisecond was skipped, and cursor continues below it.

meta
object
required