Easy Labs
APIPaymentsCustomer

Get all wallets for a customer

Retrieve a list of all wallets for a specific customer

GET
/v1/api/customer/{id}/wallets

Authorization

apiKey
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Path Parameters

id*string
Length1 <= length

Query Parameters

limit?number
Range0 <= value
offset?number
Range0 <= value
ids?string

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/v1/api/customer/string/wallets"
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": [
    {
      "id": "wa_abc123",
      "identity_id": "IDxxxxxxxxxxxxxxxxxx",
      "company_id": "comp_abc123",
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}

Get all subscriptions for a customer

Retrieve a list of all subscriptions for a specific customer. This endpoint exposes legacy Finix subscription payload fields and is included for migration compatibility.

Get all customers

Retrieve a list of customers (Finix identities) for the authenticated company. Filters: `role` (one of APPLICATION_OWNER, BENEFICIAL_OWNER, BUYER, PLATFORM_OWNER, RECIPIENT, SELLER, SENDER — values match the `finix_identity_role` DB enum); `include=instruments` (joins payment_instruments); `include_hidden=true` (returns identities tagged `hidden=true` — suppressed by default).