Skip to main content
POST
/
ramp
/
customer
/
{customer_id}
/
wallets
Search customer wallets
curl --request POST \
  --url https://api.etherfuse.com/ramp/customer/{customer_id}/wallets \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pageNumber": 0,
  "pageSize": 30
}
'
{
  "items": [
    {
      "blockchain": "stellar",
      "claimedOwnership": true,
      "createdAt": "2026-05-01T14:30:00Z",
      "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "kycStatus": "approved",
      "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
      "updatedAt": "2026-05-02T09:15:00Z",
      "walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
    }
  ],
  "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 crypto wallets

A page of crypto wallets.

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.