List All Registered Customer Bank Accounts

List Bank Accounts

curl --request GET \
  --url https://api.spherepay.co/v2/bank-account \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045",
      "status": "active",
      "customerId": "customer_66c4168d418a410eae282b83883bdc39",
      "created": "2025-01-01T00:00:00Z",
      "updated": "2025-01-01T00:00:00Z",
      "bankName": "Bank of America",
      "accountName": "Checking Account",
      "currency": "usd",
      "accountDetails": {
        "accountNumber": "****7890",
        "routingNumber": "021000021",
        "accountType": "checking"
      },
      "accountOwner": {
        "accountHolderName": "John Doe",
        "relationship": "self"
      },
      "networks": [
        "wire",
        "ach"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}

List Bank Accounts

curl --request GET \
  --url https://api.spherepay.co/v2/bank-account \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045",
      "status": "active",
      "customerId": "customer_66c4168d418a410eae282b83883bdc39",
      "created": "2025-01-01T00:00:00Z",
      "updated": "2025-01-01T00:00:00Z",
      "bankName": "Bank of America",
      "accountName": "Checking Account",
      "currency": "usd",
      "accountDetails": {
        "accountNumber": "****7890",
        "routingNumber": "021000021",
        "accountType": "checking"
      },
      "accountOwner": {
        "accountHolderName": "John Doe",
        "relationship": "self"
      },
      "networks": [
        "wire",
        "ach"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}

Use this endpoint to retrieve a paginated list of all bank accounts registered in your SpherePay account. You can optionally filter results by customer ID to fetch only the accounts belonging to a specific customer. Results are returned in descending order of creation time.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page

string

default:1

required

Page number of the list (default: 1)

Example:

1

limit

string

default:10

required

Number of items per page (default: 10)

Example:

10

customerId

string

Filter by customer ID

Example:

"customer_66c4168d418a410eae282b83883bdc39"

network

string

Response

data

(USD · object | EUR · object | BRL · object)[]

required

Array of bank account objects

Show child attributes

pagination

object

required

Show child attributes

Last modified on June 18, 2026

⌘I