Source: https://atomicwork-preview.docs-staging.pageloop.ai/api-reference/accessmanagement/getapi-v-1-iga-grants-grant-id-history

# 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 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.

## Authorization

#### X-Api-Key (header, string, required)

## Headers

#### X-Workspace-Id (header, string)

## Path Parameters

#### grant\_id (path, integer, required)

The unique identifier of the grant

## Query Parameters

#### page (query, integer)

#### per\_page (query, integer)

#### sort\_order (query, enum (string))

Sort order for grant history results

## Response

#### 200

Successful response

#### Request

```bash cURL
curl -X GET 'https://{tenant}.atomicwork.com/api/v1/iga/grants/{grant_id}/history' \
  -H 'X-Api-Key: <api-key>'
```

```javascript JavaScript
const res = await fetch('https://{tenant}.atomicwork.com/api/v1/iga/grants/{grant_id}/history', {
  method: 'GET',
  headers: {
    'X-Api-Key': '<api-key>',
  },
});
const data = await res.json();
```

```python Python
import requests

res = requests.get(
    'https://{tenant}.atomicwork.com/api/v1/iga/grants/{grant_id}/history',
    headers={'X-Api-Key': '<api-key>'}
)
data = res.json()
```