Getting started

Money, dates and versions

Three conventions hold across every endpoint.

Money

Amounts are integers in the currency's minor unit, with their ISO 4217 code: { "amount": 125000, "currency": "EUR" } is €1,250.00. A currency with no minor unit, like JPY, has none.

Dates and times

A date is YYYY-MM-DD. A timestamp is ISO 8601 in UTC, for example 2026-09-26T11:05:00Z.

Versions

Within v1 we add fields and endpoints, and never remove or rename one. Ignore the fields you do not know. A change that would break this goes to v2.