---
id: approval-list
title: "List approvals"
description: "Lists approvals."
sidebar_label: "List approvals"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/approval
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List approvals"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/approval"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists approvals.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"nrn","schema":{"type":"string"},"required":true,"description":"Specifies the resource (application, scope, etc.) that requires approval. \n\n> **Note:** This follows a hierarchical structure, meaning if approvals are set at the namespace level, all applications and scopes within that namespace will inherit the rule.\n","example":"organization=1:account=2:namespace=4:application=4:scope=5"},{"in":"query","name":"entity_name","schema":{"type":"string","description":"The entity that requires approval.","enum":["deployment","scope","service:action","parameter","action_item"],"example":"deployment","title":"entity"},"required":false,"description":"The entity that requires approval.","example":"deployment"},{"in":"query","name":"entity_action","schema":{"type":"string","description":"The action that requires approval.","enum":["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"],"example":"deployment:create","title":"action"},"required":false,"description":"The action that requires approval.","example":"deployment:create"},{"in":"query","name":"status","schema":{"type":"string","description":"The current status of the approval request.","enum":["pending","approved","auto_approved","auto_denied","denied","cancelled","expired"],"example":"pending","title":"approval_status"},"required":false,"description":"The status of the approval.","example":"pending"},{"in":"query","name":"approval_action_id","schema":{"type":"integer"},"required":false,"description":"The ID of the action that triggered this approval.","example":3456},{"in":"query","name":"dimensions","schema":{"type":"string"},"required":false,"description":"Filter approvals by the [dimensions](/docs/dimensions) of the request, as comma-separated `key:value` pairs. Returns the approvals whose dimensions are included in the specified set; approvals that don't specify dimensions always match.","example":"environment:production"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","required":["offset","limit"],"properties":{"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"results":{"type":"array","items":{"type":"object","required":["id","approval_action_id","entity_id","entity_name","entity_action","original_http_request","approval_http_request","denial_http_request","status","execution_status","user_id","dimensions"],"properties":{"id":{"type":"integer","description":"A unique identifier for the approval.","example":1234},"user_id":{"type":"integer","description":"The ID of the user who initiated this approval request.","example":2345},"approval_action_id":{"type":"integer","description":"The ID of the action that triggered this approval.","example":3456},"entity_id":{"type":"integer","description":"The ID of the entity affected by this approval.","example":4567},"entity_name":{"type":"string","description":"The entity that requires approval.","enum":["deployment","scope","service:action","parameter","action_item"],"example":"deployment","title":"entity_name"},"entity_action":{"type":"string","description":"The action that requires approval.","enum":["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"],"example":"deployment:create","title":"entity_action"},"original_http_request":{"type":"object","description":"The HTTP request that triggered the approval."},"approval_http_request":{"type":"object","description":"The HTTP request that must be executed to approve the action."},"denial_http_request":{"type":"object","description":"The HTTP request that must be executed to deny the action."},"status":{"type":"string","description":"The current status of the approval request.","enum":["pending","approved","auto_approved","auto_denied","denied","cancelled","expired"],"example":"pending","title":"approval_status"},"execution_status":{"type":"string","description":"The execution state of the approval action.","enum":["pending","executing","success","failed","expired"],"example":"pending"},"dimensions":{"type":"object","example":{"environment":"production","country":"us"},"description":"The set of dimension/values pairs to which this action applies."}},"title":"approval"}}},"title":"approvalListResponse"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>