---
title: "Get an approval"
method: GET
path: "/approvals/{approval_id}"
tags: ["approval"]
---

# Get an approval

`GET /approvals/{approval_id}`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/approvals/{approval_id}`
- Auth: HTTP bearer

Status of an approval and, once a person approved it, each item's result. Call this after sending the person to approval_url.

## Path parameters

- `approval_id` string, required: From the approval_required result.

## Response `200`

The result.

- object
  - `id` string, required
  - `status` 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled' | 'executed' | 'partially_executed' | 'failed', required
  - `summary` string, required
  - `payload_hash` string, required
  - `approval_url` string, required
  - `requester` object, required
    - `type` 'agent_connection' | 'api_key', required
    - `id` string, required
  - `on_behalf_of` string, required
  - `expires_at` string, date-time, required
  - `decided_by` string, nullable, required
  - `decided_at` string, date-time, nullable, required
  - `rejection_reason` string, nullable, required
  - `items` object[], required
    - `id` string, required
    - `position` integer, required
    - `action` string, required
    - `risk` 'outward' | 'legal' | 'admin', required
    - `summary` string, required
    - `status` 'pending' | 'approved' | 'rejected' | 'executed' | 'failed' | 'cancelled', required
    - `input` union, required
      - string
      - number
      - boolean
      - EnvelopeEventsOutSchema0[]
        - union
          - string
          - number
          - boolean
          - EnvelopeEventsOutSchema0[]
          - object
      - object
    - `result` union, required
      - string
      - number
      - boolean
      - EnvelopeEventsOutSchema0[]
        - union
          - string
          - number
          - boolean
          - EnvelopeEventsOutSchema0[]
          - object
      - object
    - `error` object, nullable, required
      - `code` string, required
      - `message` string, required
      - `hint` string
    - `executed_at` string, date-time, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

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