# Address

Explore what information is available for addresses.

This type represents a physical or postal location commonly associated with a person or organization, such as a permanent home or office address.

> **Should I use state or region?**
>
> Some countries use regions instead of states for administrative divisions, so we included both to let you choose the best option for your scenario.

## Properties

These are the available properties:

- `street`: `string|null`

  The full street address. For example, "123 Main St".

- `city`: `string|null`

  The city name. For example, "New York" or "São Paulo".

- `district`: `string|null`

  The city district. For example, "Downtown".

- `region`: `string|null`

  The name of the region or state. For example, "California".

- `state`: `string|null`

  An alias for the [`region`](#address-region-prop) property.

- `country`: `string|null`

  The country identifier. For example, "US" or "United States".

  > **Note**
  >
  > We recommend using the [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), but the identifier format is up to the implementation and can be a code, name, or any other identifier.

- `postalCode`: `string|null`

  The postal or ZIP code. For example, "90210", "SW1A 1AA", or "12345-6789".
