# Create address

Creates a new Address record. Address resource in the Animal Health Data Store

Endpoint: POST /site/{siteId}/ahds/v1/address
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `addressId` (string)
    Canonical unique identifier for the address.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `city` (string)
    City, town, or locality.
    Example: "Sydney"

  - `contactId` (string, required)
    Identifier of the contact this address belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `countryCode` (string)
    ISO 3166-1 alpha-2 country code when available; otherwise a system-specific country identifier.
    Example: "AU"

  - `distance` (object)
    Optional distance from a reference point, when returned by search operations.

  - `distance.value` (number, required)
    Numeric value
    Example: 1.5

  - `distance.unit` (string, required)
    Unit of measure
    Example: "km"

  - `distance.system` (string)
    Unit system URI
    Example: "http://unitsofmeasure.org"

  - `extensions` (object)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether the address is currently active/usable.
    Example: true

  - `latitude` (number)
    Latitude in decimal degrees (WGS84).
    Example: -33.8688

  - `line1` (string)
    First line of the street address.
    Example: "123 Main Street"

  - `line2` (string)
    Second line of the street address.
    Example: "Suite 100"

  - `longitude` (number)
    Longitude in decimal degrees (WGS84).
    Example: 151.2093

  - `name` (string)
    Optional label or name for the address (e.g., 'Home', 'Work').
    Example: "Home"

  - `postalCode` (string)
    Postal or ZIP code.
    Example: "2000"

  - `region` (string)
    Region, province, or county.
    Example: "New South Wales"

  - `state` (string)
    State or territory (where applicable).
    Example: "NSW"

  - `suburb` (string)
    Suburb, neighborhood, or village.
    Example: "Sydney"

  - `country` (object, required)
    Country represented as a coded concept, allowing explicit system and display text.

  - `country.code` (string, required)
    Code value
    Example: "12345"

  - `country.system` (string, required)
    Code system URI
    Example: "http://example.com/codesystem"

  - `country.display` (string)
    Human-readable display
    Example: "Example Display Name"

## Response 201 fields (application/json):

  - `addressId` (string, required)
    Canonical unique identifier for the address.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `city` (string, required)
    City, town, or locality.
    Example: "Sydney"

  - `contactId` (string, required)
    Identifier of the contact this address belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `countryCode` (string, required)
    ISO 3166-1 alpha-2 country code when available; otherwise a system-specific country identifier.
    Example: "AU"

  - `createdAt` (string, required)
    Timestamp when the address was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `distance` (object, required)
    Optional distance from a reference point, when returned by search operations.

  - `distance.value` (number, required)
    Numeric value
    Example: 1.5

  - `distance.unit` (string, required)
    Unit of measure
    Example: "km"

  - `distance.system` (string)
    Unit system URI
    Example: "http://unitsofmeasure.org"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether the address is currently active/usable.
    Example: true

  - `latitude` (number, required)
    Latitude in decimal degrees (WGS84).
    Example: -33.8688

  - `line1` (string, required)
    First line of the street address.
    Example: "123 Main Street"

  - `line2` (string, required)
    Second line of the street address.
    Example: "Suite 100"

  - `longitude` (number, required)
    Longitude in decimal degrees (WGS84).
    Example: 151.2093

  - `name` (string, required)
    Optional label or name for the address (e.g., 'Home', 'Work').
    Example: "Home"

  - `postalCode` (string, required)
    Postal or ZIP code.
    Example: "2000"

  - `region` (string, required)
    Region, province, or county.
    Example: "New South Wales"

  - `state` (string, required)
    State or territory (where applicable).
    Example: "NSW"

  - `suburb` (string, required)
    Suburb, neighborhood, or village.
    Example: "Sydney"

  - `updatedAt` (string, required)
    Timestamp when the address was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `country` (object, required)
    Country represented as a coded concept, allowing explicit system and display text.

  - `country.code` (string, required)
    Code value
    Example: "12345"

  - `country.system` (string, required)
    Code system URI
    Example: "http://example.com/codesystem"

  - `country.display` (string)
    Human-readable display
    Example: "Example Display Name"


## Response 400 fields

## Response 401 fields

## Response 409 fields