Partners

List withdrawal wallets

GET /api/v1/partner/customers/{customerId}/withdrawal-wallets

Returns the customer’s registered withdrawal destinations (the allowlist). Reading the allowlist does not require the merchant to be currently eligible to transact.

Request

curl -X GET https://api.niftipay.com/api/v1/partner/customers/{customerId}/withdrawal-wallets \
  -H "Authorization: Bearer <partner_api_key>"

No query parameters. The merchant is taken from the customer relationship.

Response 200

{
  "request_id": "req-1",
  "api_version": "2026-08-01",
  "data": {
    "wallets": [
      {
        "id": "w-1",
        "chain": "BTC",
        "asset": "BTC",
        "label": "Treasury",
        "address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
        "destination_tag": null,
        "created_at": "2026-08-24T10:00:00.000Z",
        "last_used_at": null
      }
    ]
  }
}

Each wallet object:

Field Type Notes
id string Destination id.
chain string Chain.
asset string Asset.
label string Display label.
address string Destination address.
destination_tag string or null Optional destination tag.
created_at string ISO-8601 timestamp.
last_used_at string or null ISO-8601 timestamp of last use, or null.

An empty list ([]) is a valid answer — it is not a 404.

Errors

503 temporarily_unavailable if the list read fails transiently — retry shortly. 500 internal_error for a permanent read failure — do not retry automatically.