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-Keyheaderstringrequired

Headers

X-Workspace-Idheaderstring

Query Parameters

search_keyquerystring

Filter entitlements by name (partial match).

app_idqueryinteger

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

typequeryenum (string)

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

statusqueryenum (string)

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

pagequeryinteger

Page number (1-indexed). Default 1.

per_pagequeryinteger

Results per page (default 25).

Response

200application/json

Successful response