Data types

Dojo uses a coherent format for data such as currencies, amounts, and dates across all of our APIs.

Currency and amount

We use the ISO 4217 standard for defining currencies. For examples, USD for US dollars or GBP for Great British pounds. We express amounts in minor units. That means they're expressed in the smallest unit of currency. For example, a GBP value of 500 represents £5, and a GBP value of 50 represents £0.50 (fifty pence).

{
  "value": 500,
  "currencyCode": "GBP"
}

Date and time

Dojo APIs express date and time according to the ISO 8601 format standard with combined date, time and timezone expressed in UTC. For example, 2021-05-12T07:45:00Z represents the 12th of May 2021 at 07:45:00. The exception to this is the expiryDate field, which accepts values in the MM/YY format.

{
  "transactionDateTime": "2021-05-12T07:45:00Z",
  "expiryDate": "04/21"
}

Country

Dojo APIs describe country codes using the two-letter ISO 3166–1–alpha–2 standard. For example, GB for Great Britain.

{
  "countryCode": "GB"
}