Check authorization status
Polls the status of a previously-created authorization request. Returns
202 Accepted while the request is pending, and 200 OK once it is
completed, expired, or failed.
On the first response with status = completed, the request is marked as
consumed; subsequent calls return 403 Forbidden. Requests older than 15
minutes are automatically transitioned to expired.
- Checks the current status of an authorization request
- Returns completion details if the user has completed the authorization flow
- Requires Bearer token authentication with your program API key
- Poll this endpoint every 2-3 seconds until status becomes
completed
Authorizations
Program API key obtained from the admin dashboard
Path Parameters
The authorization request ID
Response
Authorization status retrieved successfully
Current status of the authorization request
pending, completed, expired, failed Identity record ID (only present when status is 'completed')
When the authorization was completed (only present when status is 'completed')
Whether the identity is verified and eligible. Present for all statuses to mirror /api/verify (true for completed, false otherwise).
Filtered identity fields, mirroring /api/verify. Present when completed; null otherwise.
Present for non-success statuses (e.g., expired or failed).