API conventions

Pagination

List endpoints return page-number pagination. You can jump to any page directly and see how many pages exist.

List response shape

{
  "data": [ ... ],
  "pagination": {
    "pages": 5,
    "current_page": 2,
    "next_page": 3,
    "previous_page": 1
  }
}

Field	Description
data	Rows for this page
pagination.pages	Total pages for the current query
pagination.current_page	Page you requested (1-based)
pagination.next_page	Next page number, or null on the last page
pagination.previous_page	Previous page number, or null on the first page

Parameter	Description
page	Page number (1-based). Default 1
limit	Page size. Default 50, maximum 100

Endpoint-specific query parameters (search, filters, sort, fields) are documented on each route in the API Reference.

First page

curl -s "https://b2b-api.easyonramp.com/api/v1/users?limit=10&page=1" \
  -H "Authorization: Bearer YOUR_JWT"

Rate limits

All authenticated API traffic is rate limited per business account. Limits apply across your servers combined.

Scope	Limit	Window
Authenticated API (all endpoints)	120 requests	1 minute

When you are rate limited, the API returns 429 Too Many Requests. Response headers include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. When you receive 429:

Stop retrying immediately for that account.
Wait until the window resets (check X-RateLimit-Reset).
Use exponential backoff before resuming.
For status flows, prefer webhooks over tight polling loops.

Monetary amounts

All monetary fields in requests and responses are integer cents (minor units). The account currency uses two decimal places (for example USDC).

Value	Meaning
1050	10.50 in account currency
100000	1,000.00

Display amount (major units) = cents / 100 API amount (cents) = Math.round(majorUnits * 100)

Examples

const display = 1050 / 100;        // 10.5
const cents = Math.round(10.5 * 100); // 1050

Always send whole integers to the API. Format decimals only in your UI.

Errors

{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Bad Request"
}

Validation errors may include an array of field messages in message.

Code	Typical cause
401	Missing or invalid JWT
403	Precondition failed, for example business KYB not approved, or end-user KYC not approved for card operations
404	Resource not found or not in your tenant scope

When KYB is not approved, operational endpoints return 403.

Get started

Core concepts

Common workflows

How to manage users

How to fund your business wallet

How to use cards

How to use reports

Integration services

Rate limits

Monetary amounts

Errors

​Pagination

​Rate limits

​Monetary amounts

​Errors

Pagination

Rate limits

Monetary amounts

Errors