---
title: "List available entitlements"
method: GET
path: "/api/v1/iga/entitlements"
tags: ["accessManagement"]
---

# List available entitlements

`GET /api/v1/iga/entitlements`

List entitlements available for granting, filterable by app.
Use app_id from /iga/apps to filter.

## Query parameters

- `search_key` string
- `app_id` integer
- `type` 'GROUP' | 'ROLE'
- `status` 'DRAFT' | 'PUBLISHED'
- `page` integer
- `per_page` integer

## Headers

- `X-Api-Key` string, required
- `X-Workspace-Id` string

## Response `200`

Successful response

- AccessManagementGetapiV1IgaEntitlementsResponse200 — Empty response body

## Changes

- **2026-08-22** `6223f7496274` — 1 breaking
  - for the `query` request parameter `search_key`, the minLength was increased from `0` to `1`
- **2026-08-12** `2ab1cf36239b` — 1 info
  - api operation id `getapi-v-1-iga-entitlements` removed and replaced with `getapi_v1_iga_entitlements`

[Change history](https://skmtc.dev/atomicwork/apis/atomicwork-public-api/changes/api/v1/iga/entitlements/get.md)

---

[API](https://skmtc.dev/atomicwork/apis/atomicwork-public-api.md) · [All operations](https://skmtc.dev/atomicwork/apis/atomicwork-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atomicwork/atomicwork-public-api/revisions/6223f7496274/schema)