---
title: "Address"
url: "https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e/schemas/Address"
---

> Full API specification: https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e.md

# Address

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business API.
  version: 0.9.8
servers:
  - url: https://qa.api.zinnia.io
    description: QA Environment
  - url: https://dev.api.zinnia.io
    description: DEV Environment
  - url: https://uat.api.zinnia.io
    description: UAT Environment
  - url: https://api.zinnia.io
    description: PROD Environment
components:
  schemas:
    State:
      type: string
      example: CA
      enum:
        - AL
        - AK
        - AZ
        - AR
        - AS
        - AA
        - AE
        - AP
        - CA
        - CO
        - CT
        - DC
        - DE
        - FL
        - GA
        - GU
        - HI
        - ID
        - IL
        - IN
        - IA
        - KS
        - KY
        - LA
        - ME
        - MD
        - MA
        - MI
        - MN
        - MS
        - MO
        - MT
        - MP
        - NE
        - NV
        - NH
        - NJ
        - NM
        - NY
        - NC
        - ND
        - OH
        - OK
        - OR
        - PA
        - PR
        - RI
        - SC
        - SD
        - TN
        - TX
        - UT
        - UM
        - VT
        - VA
        - VI
        - WA
        - WV
        - WI
        - WY
      description: Abbreviated names for states
    Address:
      required:
        - id
        - addressType
        - addressLine1
        - city
        - state
        - zipCode
        - country
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the address
          example: 123e4567-e89b-12d3-a456-426614174000
        addressType:
          type: string
          enum:
            - RESIDENCE
            - BUSINESS
            - POBOX
            - SEASONAL
            - SECONDARY
            - MAILING
          description: Type of address
          example: RESIDENCE
        addressLine1:
          type: string
          description: Primary address line
          example: 123 Main St
        addressLine2:
          type: string
          description: Secondary address line (optional)
          example: Apt 4B
        addressLine3:
          type: string
          description: Secondary address line (optional)
          example: suite 123
        city:
          type: string
          description: City name
          example: San Francisco
        state:
          $ref: "#/components/schemas/State"
        zipCode:
          type: string
          pattern: ^\d{5}?$
          description: ZIP code (5 digits)
          example: "94105"
        zipCodeExt:
          type: string
          description: ZIP code extension
          example: "4465"
        country:
          type: string
          description: Country Code
          enum:
            - US
```