Skip to main content
GET
/
v1
/
customers
/
virtual-account
List Virtual Accounts
curl --request GET \
  --url https://sandbox.api.fin.com/v1/customers/virtual-account \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "virtual_accounts": [
      {
        "id": "92eceee4-ec6a-4fe3-a224-f5914cabe001",
        "status": "ACTIVE",
        "developer_fee_percent": 1.65,
        "customer_id": "196ce546-900d-4294-90ca-5546a5923f35",
        "created_at": "2025-12-22T06:09:23.456895Z",
        "updated_at": "2025-12-22T06:09:23.456895Z",
        "deposit_instructions": {
          "currency": "USD",
          "bank_name": "Bank of Nowhere",
          "bank_address": "1800 North Pole St., Orlando, FL 32801",
          "bank_routing_number": "101019644",
          "bank_account_number": "900336047672",
          "bank_beneficiary_name": "Portgas D Ace",
          "bank_beneficiary_address": "321 British Columbia City, British Columbia, BC V0C 1Y0, CA",
          "payment_rails": [
            "ACH",
            "FEDWIRE"
          ]
        },
        "destination": {
          "currency": "USDC",
          "destination_chain": "POLYGON",
          "address": "0x7f1568190e318da16a9ef5a46cba19d5b97d9b29"
        }
      },
      {
        "id": "31b1295c-9658-4ae0-bb36-4034b9b8f6e1",
        "status": "ACTIVE",
        "developer_fee_percent": 1.25,
        "customer_id": "196ce546-900d-4294-90ca-5546a5923f35",
        "created_at": "2025-12-22T06:09:12.157183Z",
        "updated_at": "2025-12-22T06:09:12.157183Z",
        "deposit_instructions": {
          "currency": "USD",
          "bank_name": "Bank of Nowhere",
          "bank_address": "1800 North Pole St., Orlando, FL 32801",
          "bank_routing_number": "101019644",
          "bank_account_number": "900123891017",
          "bank_beneficiary_name": "Portgas D Ace",
          "bank_beneficiary_address": "321 British Columbia City, British Columbia, BC V0C 1Y0, CA",
          "payment_rails": [
            "ACH",
            "FEDWIRE"
          ]
        },
        "destination": {
          "currency": "USDC",
          "destination_chain": "POLYGON",
          "address": "0x7f1568190e318da16a9ef5a46cba19d5b97d9b29"
        }
      },
      {
        "id": "56c50575-e0f5-477f-80ae-762834daf039",
        "status": "ACTIVE",
        "developer_fee_percent": 1.5,
        "customer_id": "196ce546-900d-4294-90ca-5546a5923f35",
        "created_at": "2025-12-22T06:08:34.903587Z",
        "updated_at": "2025-12-22T06:08:34.903587Z",
        "deposit_instructions": {
          "currency": "USD",
          "bank_name": "Bank of Nowhere",
          "bank_address": "1800 North Pole St., Orlando, FL 32801",
          "bank_routing_number": "101019644",
          "bank_account_number": "900119292829",
          "bank_beneficiary_name": "Portgas D Ace",
          "bank_beneficiary_address": "321 British Columbia City, British Columbia, BC V0C 1Y0, CA",
          "payment_rails": [
            "ACH",
            "FEDWIRE"
          ]
        },
        "destination": {
          "currency": "USDT",
          "destination_chain": "ETHEREUM",
          "address": "0x7f1568190e318da16a9ef5a46cba19d5b97d9b29"
        }
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 10,
      "total_page": 1,
      "total": 6
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Query Parameters

customer_id
string<uuid>
required

Unique identifier for the customer

Response

Virtual accounts retrieved successfully

data
object
required