URL: /baas/api/reference/financial-operations/get-wallets-by-customer

---
title: 'Get wallets by customer'
description: 'Retrieve a customer’s wallets and IBANs to use in financial operations.'
---

## Endpoint

`GET /api/v2.1/wallets/customer/{customerId}`

<Note>
  This endpoint requires `X-Forwarded-From` and a device header. The backend accepts any of:
  `deviceId`, `X-Device-Id`, `device-id`.
</Note>

## Sample cURL

```bash
curl --request GET \
  --url 'https://sandbox.finhub.cloud/api/v2.1/wallets/customer/{customerId}?customerType=B2C' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'X-Tenant-Id: <TENANT_ID>' \
  --header 'Accept: application/json' \
  --header 'X-Forwarded-From: <FORWARDED_FROM>' \
  --header 'deviceId: <DEVICE_ID>'
```

```bash
curl --request GET \
  --url 'https://sandbox.finhub.cloud/api/v2.1/wallets/customer/{customerId}?customerType=B2B' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'X-Tenant-Id: <TENANT_ID>' \
  --header 'Accept: application/json' \
  --header 'X-Forwarded-From: <FORWARDED_FROM>' \
  --header 'deviceId: <DEVICE_ID>'
```

## Response Example

```json
{
  "code": 200,
  "data": [
    {
      "id": "558ad9af-0482-471f-9385-5a943b80f6d2",
      "walletId": "558ad9af-0482-471f-9385-5a943b80f6d2",
      "customerId": "2dac1793-ab48-420c-b0b5-01292302e188",
      "name": "B2C Product General Purpose Wallet",
      "walletType": "b2c_product_general_purpose_wallet",
      "status": "ACTIVE",
      "currency": "EUR",
      "balance": "0.00",
      "availableBalance": "0.00",
      "iban": "LT213320011000055860"
    },
    {
      "id": "f9f66497-ef59-446b-9b32-34391b27c928",
      "walletId": "f9f66497-ef59-446b-9b32-34391b27c928",
      "customerId": "2dac1793-ab48-420c-b0b5-01292302e188",
      "name": "B2C Master General Purpose Wallet",
      "walletType": "b2c_master_general_purpose_wallet",
      "status": "ACTIVE",
      "currency": "EUR",
      "balance": "0.00",
      "availableBalance": "0.00"
    }
  ],
  "message": "Success"
}
```

<Note>
  After customer activation, poll this endpoint until wallets with IBAN appear. The IBAN is typically assigned to the Product General Purpose Wallet.
</Note>

## Missing Headers Error Example

```json
{
  "code": 500,
  "data": {
    "deviceId_accepted": [
      "deviceId",
      "X-Device-Id",
      "device-id"
    ],
    "missingHeaders": [
      "X-Forwarded-From",
      "deviceId"
    ]
  },
  "message": "Missing required header(s)"
}
```