---
title: "Get Approval by ID"
method: GET
path: "/approvals/{id}"
tags: ["Approvals"]
---

# Get Approval by ID

`GET /approvals/{id}`

## Request

- Base URL: `https://openapi.n3xt.io`
- URL: `https://openapi.n3xt.io/approvals/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/n3xt/apis/n3xt-api-documentation/docs/approvals/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a specific approval request by its ID.

## Path parameters

- `id` string, required

## Response `200`

The approval request was retrieved successfully.

- union
  - ApprovalResponse
    - `approvable` object, required
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `workflowType` string, required
      - `status` 'requested' | 'approved' | 'declined' | 'cancelled' | 'deleted' | 'failed', required
      - `authorId` string, required
      - `id` string, required
    - `data` union, required
      - object
        - `workflowType` string
        - `updatedAt` string, date-time
        - `createdAt` string, date-time
        - `authorId` string
        - `status` string, nullable
        - `amount` string
        - `recipientWalletId` string, nullable
        - `senderWalletId` string, nullable
        - `moneyFlowId` string
      - object
        - `updatedAt` string, date-time
        - `createdAt` string, date-time
        - `status` string
        - `avatarUrl` string
        - `phone` string
        - `email` string
        - `name` string
        - `businessId` string
        - `userId` string
        - `id` string
  - ErrorResponse
    - `error` string, required

## Other responses

- `400`: Bad Request - Invalid approval ID.
- `401`: Unauthorized - Invalid or missing authentication token.
- `403`: Forbidden - User does not have permission to access this approval.
- `404`: Not Found - The approval with the specified ID does not exist.
- `500`: An unexpected server error occurred while trying to retrieve the approval.

---

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