---
title: "List access revocations"
method: GET
path: "/api/v1/access_revocations"
tags: ["access_revocations"]
---

# List access revocations

`GET /api/v1/access_revocations`

## Request

- Base URL: `https://app.accessowl.io`
- URL: `https://app.accessowl.io/api/v1/access_revocations`
- Auth: HTTP bearer

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

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'processing_access' | 'revoked' | 'rejected'
- `user_id` string, uuid
- `application_id` string, uuid

## Response `200`

Access revocation list

- AccessRevocationList: Paginated list of access revocations
  - `data` AccessRevocation[], required: List of access revocations
    - `application_id` string, uuid, required: Application ID
    - `grantee_user_id` string, uuid: User ID of the grantee
    - `id` string, uuid, required: Access revocation ID
    - `inserted_at` string, date-time: Creation timestamp
    - `permission_ids` string[], nullable: Permission IDs being revoked
    - `provisioning_type` 'application_admin' | 'automatic', nullable: Provisioning type
    - `reason` string, required: Revocation reason
    - `requestor_user_id` string, uuid: User ID of the requestor
    - `resource_id` string, uuid, nullable: Resource ID (null for app-wide revocations)
    - `status` 'processing_access' | 'rejected' | 'revoked', required: Current status of the revocation
    - `termination_reason` string, nullable: The provisioner's rejection reason when the revocation was rejected; null otherwise
  - `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

## Changes

- **2026-10-31** `5a1f071e40d8`: 1 warning
  - removed the optional property `errors` from the response with the `401` status
- **2026-09-15** `209e132db90b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/accessowl/apis/accessowl-api/changes/api/v1/access_revocations/get.md)

---

[API](https://skmtc.dev/accessowl/apis/accessowl-api.md) - [All operations](https://skmtc.dev/accessowl/apis/accessowl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/accessowl/apis/accessowl-api/revisions/ff38c63d8807?raw)