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

# Transaction Time Zone Enum

> Allowed IANA time zone values (transaction_time_zone) for transaction timeZone and entity operationalHours.timezone in the gu1 API.

## Overview

The **transaction\_time\_zone** PostgreSQL enum is the allowlist for:

* **`timeZone`** on [Create Transaction](/en/api-reference/transactions/create) and [Create Batch](/en/api-reference/transactions/create-batch)
* **`operationalHours.timezone`** on [Create entity](/en/api-reference/entities/create), [person](/en/api-reference/person/create), [company](/en/api-reference/company/create), and automatic creation endpoints

If omitted on transactions, `time_zone` stays **`null`**. For entities, `operational_hours` stays **`null`** when the whole `operationalHours` object is omitted.

This is separate from `deviceDetails.timezone` (device-reported zone) and from the organization default timezone in workspace settings.

## Allowed values

| Value                            | Region (summary)             |
| -------------------------------- | ---------------------------- |
| `UTC`                            | Coordinated Universal Time   |
| `America/Noronha`                | Brazil (Fernando de Noronha) |
| `America/Argentina/Buenos_Aires` | Argentina                    |
| `America/Montevideo`             | Uruguay                      |
| `America/Sao_Paulo`              | Brazil (São Paulo)           |
| `America/Asuncion`               | Paraguay                     |
| `America/Santiago`               | Chile                        |
| `America/Caracas`                | Venezuela                    |
| `America/Manaus`                 | Brazil (Amazonas)            |
| `America/Cuiaba`                 | Brazil (Mato Grosso)         |
| `America/Bogota`                 | Colombia                     |
| `America/Lima`                   | Peru                         |
| `America/Rio_Branco`             | Brazil (Acre)                |
| `America/New_York`               | US Eastern                   |
| `America/Chicago`                | US Central                   |
| `America/Mexico_City`            | Mexico                       |
| `America/Los_Angeles`            | US Pacific                   |
| `Europe/London`                  | United Kingdom               |
| `Europe/Lisbon`                  | Portugal                     |
| `Europe/Madrid`                  | Spain                        |
| `Europe/Paris`                   | France                       |
| `Europe/Berlin`                  | Germany                      |
| `Europe/Rome`                    | Italy                        |
| `Asia/Dubai`                     | UAE                          |
| `Asia/Kolkata`                   | India                        |
| `Asia/Shanghai`                  | China                        |
| `Asia/Tokyo`                     | Japan                        |
| `Australia/Sydney`               | Australia (Sydney)           |
| `Africa/Johannesburg`            | South Africa                 |

Send the **string value** exactly as shown (case-sensitive). Do not send TypeScript enum key names.

## Usage

* **Transactions:** Optional `timeZone` (metadata; omit = `null`). Not required for create when `transactedAt` uses `Z`. When both a local datetime and `timeZone` are provided, the API can store the equivalent UTC instant. Independent of entity `operationalHours` for operational-hours rules.
* **Entities (person or company):** Optional root `operationalHours` with required `timezone` when the object is sent. See [Create entity](/en/api-reference/entities/create).
* **Get Transaction / Get entity:** Response includes `timeZone` or `operationalHours` respectively (`string | null` / object | null).

## See Also

* [Create Transaction](/en/api-reference/transactions/create)
* [Create entity](/en/api-reference/entities/create)
* [Get Transaction](/en/api-reference/transactions/get)