Skip to main content
POST
/
ramp
/
customer
/
{customer_id}
/
orders
Search customer orders
curl --request POST \
  --url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/orders \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pageNumber": 0,
  "pageSize": 30
}
'
{
  "items": [
    {
      "amountInFiat": "1000.00",
      "amountInTokens": "58.42",
      "bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "blockchain": "stellar",
      "completedAt": "2026-05-02T09:16:30Z",
      "createdAt": "2026-05-02T09:15:00Z",
      "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "depositAccountHolder": "Etherfuse MX",
      "depositBankName": "Example Bank",
      "depositClabe": "646180157000000004",
      "etherfuseMidMarketRate": "17.15",
      "exchangeRate": "17.12",
      "feeAmountInFiat": "2.00",
      "feeBps": 20,
      "orderId": "7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
      "orderType": "onramp",
      "sourceAsset": "MXN",
      "status": "completed",
      "statusPage": "https://pay.etherfuse.com/order/7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
      "stellarClaimTransaction": "AAAAAgAAAABk...base64_xdr...",
      "stellarClaimableBalanceId": "00000000abc1230000000000000000000000000000000000000000000000000000",
      "targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
      "updatedAt": "2026-05-02T09:16:30Z",
      "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 orders

A page of orders.

​
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.