Data Formats

Dates

All date and datetime fields use ISO 8601 strings in UTC:

"2025-01-15T00:00:00.000Z"

When providing a date-only value (e.g. a due date), you may pass a date string:

"2025-03-31"

Monetary amounts

All monetary amounts are returned as decimal strings to avoid floating-point precision issues:

{
  "subtotal": "1250.00",
  "tax": "125.00",
  "total": "1375.00"
}

When providing amounts in request bodies (e.g. line item unit prices), use a number or decimal string.

Currencies

Currency codes follow ISO 4217 three-letter format:

"USD"  "EUR"  "GBP"  "CAD"  "AUD"

The currency is set per-invoice and per-recurring-schedule. Clients do not have a default currency.