Skip to main content

Response envelope

Every API response uses a consistent envelope:

Pagination

List endpoints return paginated results with metadata:

Parameters

Iterating pages

Money formatting

All monetary values are returned as decimal strings to avoid IEEE 754 floating-point precision issues:
Never parse monetary values as floats. Use decimal types (Decimal in Python, BigDecimal in Java, string math in JavaScript).

Timestamps

All timestamps use ISO-8601 format in UTC:
The meta.as_of field tells you when the underlying data was last refreshed. See Data Freshness for per-endpoint details.

Incremental sync

Most list endpoints accept an updated_since parameter for incremental sync:
This returns only records modified after the given timestamp. See the Sync Merchants guide for a full implementation pattern.