---
title: "List Approval Requests"
method: GET
path: "/approvals"
tags: ["Approvals"]
---

# List Approval Requests

`GET /approvals`

## Request

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

Retrieve a list of approval requests associated with the authenticated user, each containing details such as the request ID, sender ID, recipient ID, amount, status, and timestamps.
- The status can be one of the following: requested, approved, declined, or cancelled.
- The list of approval requests is filtered based on the user's permissions and roles.

## Query parameters

- `workflowType` 'contact' | 'programmable' | 'requestPayment' | 'directPay'
- `status` string
- `limit` number, double
- `offset` number, double
- `orderBy` 'createdAt' | 'updatedAt'
- `order` 'asc' | 'desc'

## Response `200`

The list of approval requests 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 request parameters.
- `401`: Unauthorized - Invalid or missing authentication token.
- `403`: Forbidden - User does not have permission to access this resource.
- `404`: Not Found - No approvals associated with this user were found.
- `500`: An unexpected server error occurred while trying to retrieve the approvals.

---

[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)