Skip to main content

Monetary amounts

All monetary amounts are represented as integers in cents. This avoids floating-point precision issues.
Amounts are always integers, never strings or floats. Maximum precision is 2 decimal places (1 cent).
Integer cents apply to the REST API and SDKs. Tools on the hosted MCP server instead take decimal-string amounts with a required currency ("amount": "10.50", "currency": "USD"); the MCP server converts between the two encodings at the boundary.

Currency codes

ISO 4217 three-letter uppercase codes.

Timestamps

ISO 8601 / RFC 3339, always UTC.
Timestamps may include millisecond precision (2026-01-04T15:30:00.123Z). All timestamps use the Z suffix; the API does not return local time offsets.

Phone numbers

E.164 international format: plus sign, country code, subscriber number.