# Address

A postal address

Canonical URL: https://docs.paradoc.dev/schemas/primitives/address/

An Address is a structured primitive that represents a postal address.

## Properties

| Name | Type | Description |
| --- | --- | --- |
| `line1` | `string` | Primary address line (street address, PO box, company name), 1–200 characters. |
| `line2?` | `string` | Secondary address line (apartment, suite, unit, building), up to 200 characters. |
| `locality` | `string` | City, town, or locality, 1–200 characters. |
| `region` | `string` | State, province, or region, 1–100 characters. |
| `postalCode` | `string` | Postal or ZIP code: 3–20 uppercase letters, digits, spaces, or hyphens. |
| `country` | `string` | ISO country code or full country name, 2–100 characters. |

## Examples



**YAML**

```yaml
line1: 123 Main Street
line2: Suite 400
locality: San Francisco
region: CA
postalCode: "94102"
country: US
```

**JSON**

```json
{
  "line1": "123 Main Street",
  "line2": "Suite 400",
  "locality": "San Francisco",
  "region": "CA",
  "postalCode": "94102",
  "country": "US"
}
```