---
title: "AddressV2"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/AddressV2"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# AddressV2

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    AddressType:
      type: string
      enum:
        - MAILING
        - BUSINESS
        - PHYSICAL
      description: Type of address
    AddressV2:
      title: AddressV2
      type: object
      required:
        - id
        - type
        - addressLine1
        - city
        - state
        - zip
        - country
        - preferred
        - createdAt
      properties:
        id:
          type: string
          format: uuid
          description: Address identifier.
          readOnly: true
          example: 550e8400-e29b-41d4-a716-446655440000
        type:
          $ref: "#/components/schemas/AddressType"
        addressLine1:
          type: string
          description: First line of the street address.
          example: 123 Main St
        addressLine2:
          type: string
          nullable: true
          description: Second line of the street address (suite, unit, etc.).
          example: Apt 4B
        city:
          type: string
          description: City.
          example: Denver
        state:
          type: string
          minLength: 2
          maxLength: 2
          description: Two-letter US state code.
          example: CO
        zip:
          type: string
          nullable: true
          pattern: ^\d{5}(-\d{4})?$
          description: ZIP code in 5-digit or ZIP+4 format.
          example: "80202"
        county:
          type: string
          nullable: true
          description: County name.
          example: Denver
        country:
          type: string
          nullable: true
          minLength: 2
          maxLength: 2
          description: Country code (ISO alpha-2).
          example: US
        moveInDate:
          type: string
          format: date
          nullable: true
          description: Date the person moved to this address (YYYY-MM-DD).
          example: 2020-01-15
        preferred:
          type: boolean
          description: Whether this is the person's preferred address.
          example: true
        createdAt:
          type: string
          format: date-time
          description: RFC3339 UTC timestamp when the address was created.
          readOnly: true
          example: 2024-01-15T10:30:00Z
        updatedAt:
          type: string
          format: date-time
          nullable: true
          description: RFC3339 UTC timestamp when the address was last updated.
          readOnly: true
          example: 2024-01-15T14:45:00Z
```