Skip to main content
POST
/
ramp
/
customer
/
{customer_id}
/
bank-accounts
Search customer accounts
curl --request POST \
  --url https://api.etherfuse.com/ramp/customer/{customer_id}/bank-accounts \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pageNumber": 0,
  "pageSize": 30
}
'
{
  "items": [
    {
      "abbrClabe": "•••• 0004",
      "bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "compliant": true,
      "createdAt": "2026-05-01T14:30:00Z",
      "currency": "MXN",
      "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "etherfuseDepositClabe": "646180157000000004",
      "label": "Ana's SPEI account",
      "needsWork": false,
      "status": "active",
      "updatedAt": "2026-05-02T09:15:00Z"
    }
  ],
  "pageNumber": 0,
  "pageSize": 30,
  "totalItems": 42,
  "totalPages": 2,
  "next": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key sent in the Authorization header.

Path Parameters

​
customer_id
string<uuid>
required

The customer (child org) ID. Must belong to the caller's organization or a direct child.

Body

application/json
​
filters
object
Example:
{
  "fromDate": "2026-01-01T00:00:00Z",
  "toDate": "2026-06-01T00:00:00Z"
}
​
pageNumber
integer

which page of results to return (starts at 0)

Required range: x >= 0
​
pageSize
integer

The number of items to get back in one page

Required range: x >= 0

Response

Paginated bank accounts

A page of bank accounts.

​
items
object[]
required

The items on this page.

​
pageNumber
integer
required

Zero-based index of this page.

Required range: x >= 0
Example:

0

​
pageSize
integer
required

Number of items per page.

Required range: x >= 0
Example:

30

​
totalItems
integer
required

Total number of items across all pages.

Required range: x >= 0
Example:

42

​
totalPages
integer
required

Total number of pages.

Required range: x >= 0
Example:

2

​
next
string | null

URL to fetch the next page of results, if available.