# Data formats and constants

Store and send identifiers, decimals, currencies, countries, dates, and timestamps correctly.

Product: PNSL API
Guides follow API reference 2.0.0 and event reference 1.0.0.
Canonical page: https://docs.axiym.io/pnsl-api/integration-guide/fundamentals/data-formats-and-constants

The API Reference remains the source of truth for fields required by an
individual operation.

## Identifiers

Resource identifiers are UUID strings unless an operation documents another
format. Keep each identifier associated with its resource type and the
integration, environment, and resource path from which it was returned.
Store returned identifiers exactly as provided.

## Decimal amounts

Amounts and rates are decimal strings:

```json
{
  "amount": "1000.00",
  "rate": "56.5000"
}
```

Use decimal or fixed-point arithmetic. Do not convert monetary values to
binary floating point and do not send them as JSON numbers.

## Currency and country codes

* Currency codes use uppercase ISO 4217 values such as `USD` and `PHP`, or
  supported digital-currency codes such as `USDT` and `USDC`. Use the currencies
  supported by the relevant API; do not assume every code has three letters.
* Country codes use ISO 3166-1 alpha-2 uppercase values such as `SG` and `PH`.

## Dates and timestamps

| Value         | Format                    | Example                |
| ------------- | ------------------------- | ---------------------- |
| Timestamp     | ISO 8601 date-time in UTC | `2026-08-04T05:07:00Z` |
| Calendar date | ISO 8601 date             | `2026-08-04`           |

Product-specific enums, references, and encoded-data requirements are defined
by the relevant guide and API Reference.