Source: https://atomicwork-preview.docs-staging.pageloop.ai/api-reference/accessmanagement/getapi-v-1-iga-entitlements

# List available entitlements

GET `https://{tenant}.atomicwork.com/api/v1/iga/entitlements`

List the entitlements (groups, roles, licenses, repos) available for granting. Each entitlement belongs to an app and represents a specific access right that can be assigned to a user.

**Filter by app:** Pass `app_id` (from `GET /iga/apps`) to list only entitlements under a specific identity provider app.

**Filter by type:** Use the `type` parameter to narrow by entitlement category:

- `GROUP` — identity provider group membership (e.g. Azure AD security group, Okta group)
- `ROLE` — application role assignment

**Filter by status:** Use `status` to filter by publication state:

- `PUBLISHED` — available for granting
- `DRAFT` — not yet available

**Pagination:** Supports `page`, `per_page` (default 25), and `search_key` for name search.

## Authorization

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

## Headers

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

## Query Parameters

#### search\_key (query, string)

Filter entitlements by name (partial match).

#### app\_id (query, integer)

Filter entitlements under a specific app (from GET /iga/apps).

#### type (query, enum (string))

Filter by entitlement category: GROUP (IDP group membership), ROLE (application role).

#### status (query, enum (string))

Filter by publication state: PUBLISHED (available for granting), DRAFT (not yet available).

#### page (query, integer)

Page number (1-indexed). Default 1.

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

Results per page (default 25).

## Response

#### 200

Successful response

#### Request

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

```javascript JavaScript
const res = await fetch('https://{tenant}.atomicwork.com/api/v1/iga/entitlements', {
  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/entitlements',
    headers={'X-Api-Key': '<api-key>'}
)
data = res.json()
```