---
title: "List approvals"
method: GET
path: "/approval"
tags: ["Approval"]
---

# List approvals

`GET /approval`

## Request

- Base URL: `https://api.nullplatform.com`
- URL: `https://api.nullplatform.com/approval`
- Auth: HTTP bearer

Lists approvals.

## Query parameters

- `nrn` string, required
- `entity_name` 'deployment' | 'scope' | 'service:action' | 'parameter' | 'action_item': 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': The action that requires approval.
- `status` 'pending' | 'approved' | 'auto_approved' | 'auto_denied' | 'denied' | 'cancelled' | 'expired': The current status of the approval request.
- `approval_action_id` integer
- `dimensions` string

## Response `200`

The operation was successful.

- ApprovalListResponse
  - `paging` object, required
    - `offset` integer, required: The starting point for pagination. Defaults to 0 if not provided.
    - `limit` integer, required: The maximum number of results to return per page. The maximum allowed value is 200.
  - `results` Approval[], required
    - `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`: The request couldn't be processed. For example, a parameter is invalid, the resource doesn't exist, or you don't have permission. The body is a problem details object (RFC 9457).
- `5XX`: Something went wrong on nullplatform's side. The body is a problem details object (RFC 9457).

## Changes

- **2026-10-15** `728d4df70ca1`: 6 breaking, 15 info
  - the response property `message` became optional for the status `4XX`
  - the response property `message` became optional for the status `5XX`
  - removed the required property `error` from the response with the `4XX` status
  - removed the required property `error` from the response with the `5XX` status
  - …17 more
- **2026-09-10** `48f4b247ee12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nullplatform/apis/nullplatform-api/changes/approval/get.md)

---

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