---
title: "List Funding Requests"
method: GET
path: "/v1/funding-request"
tags: ["Funding Requests"]
---

# List Funding Requests

`GET /v1/funding-request`

## Request

- Base URL: `https://cams.aquanow.com/api`
- URL: `https://cams.aquanow.com/api/v1/funding-request`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/aquanow/apis/aquanow-cams-rest-api/docs/v1/funding-request/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of funding requests with optional filtering and pagination.

## Query parameters

- `after` string
- `limit` string, integer
- `fundingRequestId` string, uuid
- `customerAccountId` string, uuid
- `beneficiaryAccountId` string, uuid
- `beneficiaryCurrency` 'AED' | 'USD'
- `fundingCurrency` 'USDC' | 'USDT'
- `network` string
- `status` 'PENDING_ADDRESS' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'REMOVED'
- `createdAtStart` string, date-time
- `createdAtEnd` string, date-time
- `expiresAtStart` string, date-time
- `expiresAtEnd` string, date-time
- `customerReference` string
- `sortField` 'status' | 'createdAt'
- `sortDirection` 'ASC' | 'DESC'

## Response `200`

Successful response

- object
  - `after` string, nullable: The token of the last item in the response
  - `totalCount` string, integer: The total number of items in the entire filtered data set
  - `items` FundingRequest[]
    - `customerReference` string, nullable
    - `customerAccountId` string, uuid, required
    - `feePaidBy` 'MERCHANT', required
    - `fundingRequestId` string, uuid, required
    - `fundingInstructions` FundingInstructions, required
      - `address` string, required: The deposit address for funding
      - `fundingCurrency` string, required
      - `network` string, required: The blockchain network
    - `status` 'PENDING_ADDRESS' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'REMOVED', required
    - `conversionRate` string, number, required
    - `beneficiaryAccountId` string, uuid, required
    - `beneficiaryCurrency` string, required
    - `expiresAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `depositIds` string[], required

## Other responses

- `400`: Validation Error
- `401`: Unauthorized
- `403`: Insufficient Privileges
- `4XX`: Client error
- `5XX`: Server error

---

[API](https://skmtc.dev/aquanow/apis/aquanow-cams-rest-api.md) - [All operations](https://skmtc.dev/aquanow/apis/aquanow-cams-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aquanow/apis/aquanow-cams-rest-api/revisions/c62a02b27407?raw)