Pular para o conteúdo principal
List Bank Accounts
curl --request GET \
  --url https://api.spherepay.co/v2/bank-account \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045",
      "status": "active",
      "bankName": "Chase",
      "accountName": "Jane Doe Checking",
      "customerId": "customer_66c4168d418a410eae282b83883bdc39",
      "created": "2025-01-01T00:00:00Z",
      "updated": "2025-01-01T00:00:00Z",
      "currency": "usd",
      "accountDetails": {
        "accountNumber": "****7890",
        "routingNumber": "021000021",
        "accountType": "checking"
      },
      "accountOwner": {
        "accountHolderName": "Jane Doe",
        "relationship": "self"
      },
      "networks": [
        "ach",
        "wire"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}
Use este endpoint para recuperar uma lista paginada de todas as contas bancárias registradas na sua conta SpherePay. Você pode opcionalmente filtrar os resultados por ID de cliente para buscar apenas as contas pertencentes a um cliente específico. Os resultados são retornados em ordem decrescente de tempo de criação.

Autorizações

​
Authorization
string
header
obrigatório

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

Parâmetros de consulta

​
page
string
padrão:1
obrigatório

Page number of the list (default: 1)

Exemplo:

1

​
limit
string
padrão:10
obrigatório

Number of items per page (default: 10)

Exemplo:

10

​
customerId
string

Filter by customer ID

Exemplo:

"customer_66c4168d418a410eae282b83883bdc39"

Resposta

​
data
(USD · object | EUR · object | BRL · object)[]
obrigatório

Array of bank account objects

​
pagination
object
obrigatório
Última modificação em 18 de junho de 2026