---
title: "Get an access revocation"
method: GET
path: "/api/v1/access_revocations/{id}"
tags: ["access_revocations"]
---

# Get an access revocation

`GET /api/v1/access_revocations/{id}`

## Request

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

Returns a single access revocation by its ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

Access revocation

- AccessRevocation: An access revocation
  - `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

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found

## Changes

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

[Operation history](https://skmtc.dev/accessowl/apis/accessowl-api/changes/api/v1/access_revocations/:id/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)