Get grant history | Atomicwork

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 of GRANTED, EXTENDED, REVOKED, or EXPIRED
event_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.

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 of `GRANTED`, `EXTENDED`, `REVOKED`, or `EXPIRED` - `event_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.

Authentication

X-Api-Keystring

API Key authentication via header

Path parameters

grant_idlongRequired

The unique identifier of the grant

Headers

X-Workspace-IdstringOptional

Query parameters

pageintegerOptionalDefaults to 1

per_pageintegerOptionalDefaults to 25

sort_orderenumOptional

Sort order for grant history results

Allowed values:

Response

Successful response

$	curl -G https://{tenant}.atomicwork.com/api/v1/iga/grants/1/history \
>	-H "X-Workspace-Id: {{workspace_id}}" \
>	-H "X-Api-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d sort_order=CREATED_AT_ASC

1	{
2	"history": [
3	{
4	"event_type": "GRANTED",
5	"event_at": "2024-04-10T09:15:30Z",
6	"event_by": "admin_user_jdoe"
7	},
8	{
9	"event_type": "EXTENDED",
10	"event_at": "2024-05-10T09:15:30Z",
11	"event_by": "system_automation"
12	},
13	{
14	"event_type": "REVOKED",
15	"event_at": "2024-06-01T16:45:00Z",
16	"event_by": "security_officer_asmith"
17	}
18	],
19	"page": 1,
20	"per_page": 25,
21	"total_entries": 3,
22	"sort_order": "CREATED_AT_DESC"
23	}