Response envelope
Every API response uses a consistent envelope:
List endpoints return paginated results with metadata:
Parameters
Iterating pages
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.