Effortless customer verification now available   View changelog →
SpherePaySpherePay
Wallet

List Wallets

List all wallets with pagination. Optionally filter by customer.

GET
/v2/wallet

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

pagestring

Page number of the list (default: 1)

Default"1"
limitstring

Number of items per page (default: 10)

Default"10"
customerId?string

Filter by customer ID

Response Body

curl -X GET "https://api.spherepay.co/v2/wallet?page=1&limit=10&customerId=customer_66c4168d418a410eae282b83883bdc39"
{
  "data": [
    {
      "id": "wallet_ce745ef7f3df4b9a8bff1301ce24b045",
      "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "network": "sol",
      "customerId": "customer_66c4168d418a410eae282b83883bdc39",
      "created": "2025-01-01T00:00:00.000Z",
      "updated": "2025-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}

{
  "status": 400,
  "detail": "Invalid request parameters",
  "code": "address/invalid",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 404,
  "detail": "Resource not found",
  "code": "resource/not-found",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 422,
  "detail": "Validation failed",
  "code": "validation/failed",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
  "errors": [
    {
      "detail": "Invalid email format",
      "pointer": "/email"
    },
    {
      "detail": "Name is required",
      "pointer": "/name"
    }
  ]
}