Skip to main content

Monetary amounts

All monetary amounts are represented as strings in minor units (cents for USD). This avoids floating-point precision issues.
API valueDollars
"100"$1.00
"500000"$5,000.00
"1234"$12.34
{
  "amount": "500000",
  "currency": "USD"
}
Amounts are always strings — never integers or floats. Maximum precision is 2 decimal places (1 cent).

Currency codes

ISO 4217 three-letter uppercase codes.
{
  "currency": "USD"
}

Timestamps

ISO 8601 / RFC 3339, always UTC.
{
  "created_at": "2026-01-04T15:30:00Z"
}
Microsecond precision is supported (2026-01-04T15:30:00.123456Z). All timestamps use the Z suffix — the API does not return local time offsets.

Dates

ISO 8601 date-only format (YYYY-MM-DD) for fields without a time component.
{
  "legal_date": "1990-03-15"
}

Phone numbers

E.164 international format: plus sign, country code, subscriber number.
{
  "phone": "+14155551234"
}

Country codes

ISO 3166-1 alpha-2 two-letter uppercase codes.
{
  "country": "US"
}

State and province codes

ISO 3166-2 subdivision codes for the state field in addresses.
{
  "state": "CA"
}