---
id: approval-action-list
title: "List actions"
description: "List approval actions filtered by NRN, entity, action, or dimensions."
sidebar_label: "List actions"
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 actions"}
>
</Heading>

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



List approval actions filtered by NRN, entity, action, or dimensions.

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

<ParamsDetails
  parameters={[{"in":"query","name":"nrn","schema":{"type":"string"},"required":true,"description":"The resource that will be subject to approvals. \n\n> **Note:** This is a hierarchical setting, so if you set approvals for a namespace, then all applications and scopes inside the namespace will match against the action.\n","example":"organization=1:account=2:namespace=4:application=4:scope=5"},{"in":"query","name":"entity","schema":{"type":"string","description":"The entity that requires approval.","enum":["deployment","scope","service:action","parameter","action_item"],"example":"deployment","title":"entity"},"required":true,"description":"The entity that requires approval.","example":"deployment"},{"in":"query","name":"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":true,"description":"The action that requires approval.","example":"deployment:create"},{"in":"query","name":"dimensions","schema":{"type":"string"},"required":false,"description":"Specify the [dimensions](/docs/dimensions) you have configured.You can include multiple key-value pairs, separated by commas","example":"environment:production,country:us"},{"schema":{"type":"boolean","default":false},"in":"query","name":"show_descendants","required":false,"description":"Specifies whether to show entities defined in the lower level of the NRN hierarchy"}]}
>
  
</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","nrn","entity","action"],"properties":{"id":{"type":"integer","description":"A unique identifier for the approval action.","example":1234},"nrn":{"type":"string","description":"A resource identifier (NRN) specifying where this action applies.","example":"organization=1:account=2:namespace=3:application=4"},"entity":{"type":"string","description":"The entity that requires approval.","enum":["deployment","scope","service:action","parameter","action_item"],"example":"deployment","title":"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":"action"},"dimensions":{"type":"object","description":"Key-value pairs defining the scope of the action.","example":{"environment":"production","country":"us"}},"on_policy_success":{"type":"string","enum":["approve","manual"],"description":"The action to be taken when the policy check is successful.\n\n> **Note:** If omitted, this value defaults to **manual**.\n","example":"approve"},"on_policy_fail":{"type":"string","enum":["manual","deny"],"description":"The action to be taken when the policy check fails.\n\n> **Note:** If omitted, this value defaults to **manual**.\n","example":"deny"},"on_checklist_fail":{"type":"string","enum":["deny","pending","manual"],"description":"What happens to the request when its checklist run resolves as `fail`. Only read in checklist mode; policy-mode actions use `on_policy_fail` instead.\n\n- `deny`: the request is denied outright. Reviewers are never notified and manual review can't be requested.\n- `pending`: the request stays open. The requester fixes the cause and requests again, cancels, or asks for a manual review, which is when reviewers are notified.\n- `manual`: the request goes to manual review right away and reviewers are notified.\n\n> **Note:** If omitted, this value defaults to **pending**. An invalid value returns `400 INVALID_CHECKLIST_FAIL_PATH`.\n","example":"manual","title":"on_checklist_fail"},"time_to_reply":{"type":"integer","description":"How long (in milliseconds) approvers have to respond before the request expires. If the window closes without a decision, the request status moves to `expired`.","example":259200000},"allowed_time_to_execute":{"type":"integer","description":"How long (in milliseconds) after approval the action can be executed. If execution doesn't happen within this window, the `execution_status` moves to `expired`.","example":86400000}},"title":"approval_action"}}},"title":"actionListResponse"}}}},"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>