---
title: "List access requests"
method: GET
path: "/api/v1/access_requests"
tags: ["access_requests"]
---

# List access requests

`GET /api/v1/access_requests`

Returns a paginated list of access requests visible to the authenticated caller.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Access request list

- AccessRequestList — Paginated list of access requests
  - `data` AccessRequest[], required — List of access requests
    - `application_id` string, uuid, required — Application ID
    - `duration` string, nullable — Duration of time-based access as an ISO 8601 duration (e.g. "PT1H", "P7D"); null for permanent access
    - `expires_at` string, date-time, nullable — When the time-based access expires; null for permanent access or a time-based request that has not been granted yet
    - `grantee_user_id` string, uuid — User ID of the grantee
    - `id` string, uuid, required — Access request ID
    - `inserted_at` string, date-time — Creation timestamp
    - `permission_ids` string[], required — Requested permission IDs
    - `provisioning_type` 'application_admin' | 'automatic', nullable — Provisioning type
    - `request_reason` string, required — Request reason
    - `requestor_user_id` string, uuid — User ID of the requestor
    - `resource_id` string, uuid, required — Resource ID
    - `status` 'pending_approval' | 'pending_permissions_assignment' | 'access_granted' | 'denied' | 'rejected' | 'processing_access' | 'scheduled' | 'pending_dependency', required — Current status of the access request
  - `meta` PaginationMeta, required — Pagination metadata
    - `page` integer, required — Current page number
    - `page_size` integer, required — Items per page
    - `total_count` integer, required — Total number of items
    - `total_pages` integer, required — Total number of pages

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.net/accessowl/apis/accessowl-api.md) · [All operations](https://skmtc.net/accessowl/apis/accessowl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/accessowl/accessowl-api/versions/f01f507d4b4e/schema)