> ## Documentation Index
> Fetch the complete documentation index at: https://docs.natural.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Formats

> Data formats and units used across the API

## Monetary amounts

All monetary amounts are represented as **integers in cents**. This avoids floating-point precision issues.

| API value | Dollars    |
| --------- | ---------- |
| `100`     | \$1.00     |
| `500000`  | \$5,000.00 |
| `1234`    | \$12.34    |

```json theme={null}
{
  "amount": 500000,
  "currency": "USD"
}
```

Amounts are always integers — never strings or floats. Maximum precision is 2 decimal places (1 cent).

## Currency codes

[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) three-letter uppercase codes.

```json theme={null}
{
  "currency": "USD"
}
```

## Timestamps

[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) / [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339), always UTC.

```json theme={null}
{
  "createdAt": "2026-01-04T15:30:00Z"
}
```

Timestamps are returned with millisecond precision (`2026-01-04T15:30:00.123Z`). 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.

```json theme={null}
{
  "legalDate": "1990-03-15"
}
```

## Phone numbers

[E.164](https://en.wikipedia.org/wiki/E.164) international format: plus sign, country code, subscriber number.

```json theme={null}
{
  "phone": "+14155551234"
}
```

## Country codes

[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) two-letter uppercase codes.

```json theme={null}
{
  "country": "US"
}
```

## State and province codes

[ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) subdivision codes for the `state` field in addresses.

```json theme={null}
{
  "state": "CA"
}
```