---
id: approval-read
title: "Read an approval"
description: "Reads an approval."
sidebar_label: "Read an approval"
hide_title: true
hide_table_of_contents: true
api: eJzdWNuO2zYQ/RWCTwmg2M5eUkBv2zRtt09BskEDbBaLsTi2JpFIhRfvuob+vRjqYkn2djdF2gJ9kUWanDNz5sIRd1KhyyxVnoyWqXyHoJwALaCqrNlAMZOJNBVa4AWXSqay+ye1CEom0sPayfRaXrTz8iaRDrNgyW9ler2TSwSL9iL4XKbXN/VNIiuwUKJH6+ICYuQKfC4TqaFEmUpiyS7LsQSZ7qTfVnFWe1yjlXUiLX4NZFHJ1NuAycSMqxzF5U/CrITPcWQL3kNZFSjTlyenZ6yLRVcZ7dAxzsliwT+HwnoKxB044UKWoXOrEEVmRnvUnjdCVRWUxYXzz4537w6tMMvPmHk5tOG6MbhT9BYyFnEbJ1F78tvReySpHzWL2U+W1qShuM29r25ZOjo/FDuZV6jpcNZ58MFFqjALUY9+Kji0jSaKStSOjHbs78oyQZ4aFkkd8dnURRciaPoaUJBiO1aEVqyMfcRhexUeRxgHAe8Td7kRpMkTeFTC5+R6LNEyMMI8OT07r4/65Vvhm53C5+CFt7Reo51qMEI+PTt/VQ+d/62AzU4BqxVmbOxy+xdoZ+evfqjH4bXHc96SXh+Fa0GiVW00TxB0KDm8FVaF2ZacJpzXpuL4dWg3lGHaB3BfFzhoW6o9lhxhvapjUZ58nBxqXk8z40mmDB30RFPSzCJ47CyaDi1OJu4sDUYKCxwMnTfVASd7kT01sey+cCzbuzFPqUVnig1OZhWupoymFmMNeoDYPeyE35bQ+qFac6TIHTL969XV2y7bDhNimP31Q7Xrb+KUwXmxRNFUNoYzLRoOkjTiHquN3xFVod5OIdsq+6RozYK1qL1o9kwPulEta8O2Qq0aaa3F8cAJ3txOx2x6HPUvGegMiyK+430Vz6xR6OyFdwHT+621qj5ynjytxHS7oq14YGpH4DFL273xvT2zZSJXQE8wpR6dcUdc32/ZSdQbskbHmpTyYahCV9IyE7S3W5nKhoRDAx16NqoHm2+gCOhEBWQdx8pdTlneFu+mSMU2A91M1vUh47Kuefrs48fDVuZ1QRw1aK2xou98hArIQKQ3UJASpKvghbGiJOdIr8W+X/tu/U4TAq+Nio0M6yMTWaJzsMbDjmKw+vFzMGZgmxiZUSgsVhYdlzC9jsHjKsxoRZnIhnw8w9l6loizxYIfL/lxyo+z5+OzcrGomQT1hDPyQpSQ5aTxBVdtWBbYYkW9YnXIwOPaWPoDXaMb2g23QkBFsDhClktQfTGqO9qeoMTSEq4SkYcS9F6Twaq+aYjKsbiOjU/yR1DiXQP6SfLEBw3B51Fl9UmOyRmuZhU7jz6upFLEr1AIhR6ocAKWJvi9WmMczpyuynJLXkKxMrZEJSK72gNpVH1IDyO4rpsMOT+WIe8b+qcZQlrFONdr/jgi5wKK2C2guHh7KRwp/J+lhhsS0QbDOafG+eKEH6djx5//d1nBxlpuRZpFtw1l/1p+XLbwog2dN7ymyZT3TTMnPmjYABUs9SBhjm7/R1PnQoug8b5qvgsak0wWOwo1E28LBIfC262ANZAWBXi0XdZEvXxu+CJgjT42pvxdL+fd8TPfkarbRrb7wA+2kKnkXsql8zlUNNOhKKoCPOfsLDOlrAe3Bu85TZroHt4d9DywoO56IJbFuEgm7cvPxpbAB/Fvv1/FE5L0yvB21qeh7OVsMVsMupX+7qJOZGWcLyHma3sZwZciwzuRqQd2+7w/foHS6u3x3s+rAih20JGUXcvftRwITyn2JLnhnvNa7nZLcPjBFnXN018Dcj9xfZPIDVjioIokK3L8rmS6gsJNr0SGOj5711ab5+Lhi5KjOreToLeS0YvAI5nIL7htLm3qmzqROYJCG5Vq/rjIMqz8YMtBcWT394H1y5urphcdOn3i5Cj9qDq7XbPiynxBXde9dp7HrGBd/wl9jJyd
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={"Read an approval"}
>
</Heading>

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



Reads an approval.

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

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"integer"},"required":true,"description":"The ID of the approval.","example":1234}]}
>
  
</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":["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"}}}},"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>