> For the complete documentation index, see [llms.txt](https://docs.exto360.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exto360.com/integration/data-formats.md).

# Data Formats

### Currency

Our API represents currency values using a structured format to ensure clarity and precision. Each currency field includes:

* **`label`** → A human-readable formatted amount with the currency symbol (e.g., `"12.000 USD"`).
* **`value`** → The numeric value of the currency (e.g., `12`).
* **`currency`** → The corresponding currency code following the **ISO 4217** standard (e.g., `"USD"`).

```json
"customFields": {
    "currency": 
        {
            "label": "12.000 USD",
            "value": 12,
            "currency": "USD"
        }
}        
```

This format ensures consistency across different currency representations, making it easy for clients to parse and display amounts accurately.

### Date and Datetime

Our API returns all date and date-time values in  [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) ([RFC 3339 "full-date"](https://tools.ietf.org/html/rfc3339#section-5.6))  format, ensuring consistency across time zones and systems.

**Date Format (YYYY-MM-DD)**

* All **dates** are represented in the **full-date format** (`YYYY-MM-DD`).
* Example: **December 30, 2024** is represented as `"2024-12-30"`.

**Date-Time Format (YYYY-MM-DDTHH:mm:ss.sssZ)**

* All **date-time values** are represented in **UTC (Coordinated Universal Time)** using the `YYYY-MM-DDTHH:mm:ss.sssZ` format.
* Example: **December 1, 2024, at 18:18:40 UTC** is represented as `"2024-12-01T18:18:40.599Z"`.

```json
{
    "customFields" : {
        "dueDate": "2024-12-30",
    },
    "createdAt": "2024-12-01T18:18:40.599Z",
    "updatedAt": "2023-12-01T18:18:40.740Z",
}
```

### Timezone

* All dates and date-time values follow **UTC (Coordinated Universal Time)**.
* The `"Z"` at the end of date-time values (`2024-12-01T18:18:40.599Z`) indicates that the timestamp is in **UTC**.

By using [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) and UTC, our API ensures accurate time representation, making it easier for applications to handle global time differences.