---
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"},"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>