List access states
Changed onReturns a paginated list of access states — records of who currently has (or historically had) access to which application resources, including effective time ranges.
Request
- Base URLhttps://app.accessowl.io
- URLhttps://app.accessowl.io/api/v1/access_states
- AuthHTTP bearer
Query parameters
Maximum results to return (default: 20, max: 100)
Opaque cursor returned in the previous response's meta.next_cursor. Omit for the first page.
Filter by application ID
Filter by grantee user ID
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
Example response
{
"data": [
{
"grantee_user": {
"deactivated_at": null,
"departments": [
"Engineering"
],
"email": "john@example.com",
"employment_type": "full_time",
"first_name": "John",
"full_name": "John Doe",
"id": "7488a646-e31f-11e4-aace-600308960662",
"inserted_at": "2023-01-01T00:00:00Z",
"job_title": "Software Engineer",
"last_name": "Doe",
"location_city": "San Francisco",
"manager_user_id": null,
"offboarding_scheduled_at": null,
"onboarding_scheduled_at": null,
"status": "active",
"teams": [
"Engineering",
"Backend"
],
"updated_at": "2023-01-01T00:00:00Z"
}
}
],
"meta": {
"page": 1,
"page_size": 20,
"total_count": 100,
"total_pages": 5
}
}Changes
- warning
removed the optional property
from the response with the status
- warning
- info
added the optional property
////to the response with the status - info
added the optional property
////to the response with the status
- info