v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Deposit Fiat

Master Wallet List Payment Orders

get/v1/wallets/{id}/deposit/fiat/orders

Path parameters

idstring uuid required

Wallet identifier.

Query parameters

Current payment-order lifecycle status.

Filter by payment-order status.

rail'one_time_virtual_account' | 'payment_link' | 'qr_code'

Supported fiat collection rail.

Payment collection rail.

currencystring

ISO 4217 fiat currency code.

assetIdstring uuid

Stablecoin asset identifier returned by the supported-assets endpoint.

searchstring

Search by reference, label, account name, or account number.

startDatestring date-time

Inclusive ISO 8601 start date. Required only when endDate is supplied.

endDatestring date-time

Inclusive ISO 8601 end date. Required only when startDate is supplied.

pageinteger

One-based page number.

limitinteger

Records per page. Maximum 100.

Response

Successful response.

statusCodeinteger required

messagestring required

Human-readable result.

Example response

{
  "statusCode": 200,
  "message": "Payment orders fetched successfully",
  "data": [
    {
      "id": "80ea45ab-38b9-4506-b213-52da8bc7e825",
      "type": "deposit",
      "reference": "dep_20260719_001",
      "providerReference": "provider_order_839201",
      "currency": "NGN",
      "amount": "100.00",
      "amountFiat": "155000.00",
      "feeFiat": "1500.00",
      "amountFiatPayable": "156500.00",
      "expiresAt": "2026-07-19T13:00:00.000Z",
      "paymentInstructions": {
        "bank": {
          "name": "Example Bank",
          "code": "999",
          "accountName": "Blockradar / Acme Ltd",
          "accountNumber": "0123456789"
        },
        "paymentLink": {
          "url": "https://pay.example.com/order/839201"
        },
        "qrCode": {
          "payload": "000201010212...",
          "imageUrl": "https://pay.example.com/qr/839201.png"
        },
        "expiresAt": "2026-07-19T13:00:00.000Z"
      },
      "provider": {
        "id": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
        "slug": "example-provider",
        "name": "Example Provider"
      },
      "wallet": {
        "id": "4465468a-3c36-4536-918a-91d689e18a74",
        "address": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a"
      },
      "address": {
        "id": "a2746f77-56b1-4b34-b0f3-53ad99bf53e2",
        "address": "0x8Fcb...f12"
      },
      "asset": {
        "id": "ae455f23-3824-4125-baab-d158315cbcbd",
        "symbol": "USDC",
        "name": "USD Coin"
      },
      "customer": {
        "id": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a"
      },
      "createdAt": "2026-07-19T12:30:00.000Z",
      "updatedAt": "2026-07-19T12:30:00.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 10,
    "pageCount": 1
  },
  "links": {
    "first": "https://api.blockradar.co/v1/example?page=1&limit=10",
    "last": "https://api.blockradar.co/v1/example?page=1&limit=10"
  },
  "analytics": {
    "totalOrdersCount": 1,
    "totalPendingOrdersCount": 1
  }
}