---
title: "Read an approval"
method: GET
path: "/approval/{id}"
tags: ["Approval"]
---

# Read an approval

`GET /approval/{id}`

Reads an approval.

## Path parameters

- `id` integer, required

## Response `200`

The operation was successful.

- Approval
  - `id` integer, required — A unique identifier for the approval.
  - `user_id` integer, required — The ID of the user who initiated this approval request.
  - `approval_action_id` integer, required — The ID of the action that triggered this approval.
  - `entity_id` integer, required — The ID of the entity affected by this approval.
  - `entity_name` 'deployment' | 'scope' | 'service:action' | 'parameter' | 'action_item', required — The entity that requires approval.
  - `entity_action` 'deployment:create' | 'scope:create' | 'scope:recreate' | 'scope:write' | 'scope:delete' | 'scope:stop' | 'service:action:create' | 'parameter:read-secrets' | 'action_item:resolve' | 'action_item:defer' | 'action_item:reject', required — The action that requires approval.
  - `original_http_request` object, required — The HTTP request that triggered the approval.
  - `approval_http_request` object, required — The HTTP request that must be executed to approve the action.
  - `denial_http_request` object, required — The HTTP request that must be executed to deny the action.
  - `status` 'pending' | 'approved' | 'auto_approved' | 'auto_denied' | 'denied' | 'cancelled' | 'expired', required — The current status of the approval request.
  - `execution_status` 'pending' | 'executing' | 'success' | 'failed' | 'expired', required — The execution state of the approval action.
  - `dimensions` object, required — The set of dimension/values pairs to which this action applies.

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Server error responses indicating an issue on the API side.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)