Get grant history
GET https://{tenant}.atomicwork.com/api/v1/iga/grants/{grant_id}/history
Retrieve the complete audit trail for a specific grant. Returns a paginated timeline of all lifecycle events — creation, extensions, revocations, and expirations — with timestamps and actors.
Each history entry includes:
event_type— one ofGRANTED,EXTENDED,REVOKED, orEXPIREDevent_at— when the event occurred (ISO 8601)event_by— who or what triggered the event
Pagination: Supports page, per_page, and sort_order (CREATED_AT_ASC or CREATED_AT_DESC). Default sort is newest first.
Authorization
X-Api-KeyrequiredHeaders
X-Workspace-IdPath Parameters
grant_idrequiredThe unique identifier of the grant
Query Parameters
pageper_pagesort_orderSort order for grant history results
Response
200application/json
Successful response