Data types

This section describes the data types and formats used consistently in the Numeral API.

Data typeDescription
AmountUnless indicated otherwise, any amount is expressed in absolute value, as an integer, in the currency's smallest unit.

For euro, the smallest unit is cents. €20 is represented as 2000.
DateDate in YYYY-MM-DD format, eg 2021-04-25.
Datetime Date and time with timezone information in ISO 8601 YYYY-MM-DDTHH:mm:ssZ format, eg 2021-04-25T17:22:18+0000. Unless indicated otherwise, Numeral uses UTC.
Country codeISO 3166 alpha-2 country code, eg GB, FR, US.
Currency codeISO 4217 currency code, eg GBP, EUR, USD.