Skip to main content
GET
List access states

Authorizations

Authorization
string
header
required

Bearer token authentication. Pass your AccessOwl API token in the Authorization header as Bearer <token>.

Query Parameters

limit
integer

Maximum results to return (default: 20, max: 100)

cursor
string

Opaque cursor returned in the previous response's meta.next_cursor. Omit for the first page.

application_id
string

Filter by application ID

grantee_user_id
string

Filter by grantee user ID

expand
string

Comma-separated list of related objects to embed inline alongside their ID fields. Allowed values: grantee_user, application, resource, target_permissions. Embedded objects carry their own top-level fields only (no further nesting). An unknown value returns 400.

Response

Access state list

Paginated list of access states

data
AccessState · object[]
required

List of access states

meta
PaginationMeta · object
required

Pagination metadata

Example: