Skip to content

AHDS Store API (1.0)

Animal Health Data Store - V1 API Documentation

Overview
Languages
Servers
Mock server

https://docs.heydonto.com/_mock/apis/animal-health/openapi/

Local Development

http://localhost:8083/

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Request

Fully replaces an existing Address. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

addressIdstringrequired

Address unique identifier (UUID)

Bodyapplication/jsonrequired
citystringrequired

City, town, or locality.

Example: "Sydney"
contactIdstringrequired

Identifier of the contact this address belongs to.

Example: "123e4567-e89b-12d3-a456-426614174000"
countryCodestringrequired

ISO 3166-1 alpha-2 country code when available; otherwise a system-specific country identifier.

Example: "AU"
distanceobjectrequired
distance.​valuenumberrequired

Numeric value

Example: 1.5
distance.​unitstringrequired

Unit of measure

Example: "km"
distance.​systemstring

Unit system URI

Example: "http://unitsofmeasure.org"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the address is currently active/usable.

Example: true
latitudenumberrequired

Latitude in decimal degrees (WGS84).

Example: -33.8688
line1stringrequired

First line of the street address.

Example: "123 Main Street"
line2stringrequired

Second line of the street address.

Example: "Suite 100"
longitudenumberrequired

Longitude in decimal degrees (WGS84).

Example: 151.2093
namestringrequired

Optional label or name for the address (e.g., 'Home', 'Work').

Example: "Home"
postalCodestringrequired

Postal or ZIP code.

Example: "2000"
regionstringrequired

Region, province, or county.

Example: "New South Wales"
statestringrequired

State or territory (where applicable).

Example: "NSW"
suburbstringrequired

Suburb, neighborhood, or village.

Example: "Sydney"
countryobjectrequired
country.​codestringrequired

Code value

Example: "12345"
country.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
country.​displaystring

Human-readable display

Example: "Example Display Name"
curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/address/{addressId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "city": "Sydney",
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "countryCode": "AU",
    "distance": {
      "value": 1.5,
      "unit": "km",
      "system": "http://unitsofmeasure.org"
    },
    "extensions": {},
    "isActive": true,
    "latitude": -33.8688,
    "line1": "123 Main Street",
    "line2": "Suite 100",
    "longitude": 151.2093,
    "name": "Home",
    "postalCode": "2000",
    "region": "New South Wales",
    "state": "NSW",
    "suburb": "Sydney",
    "country": {
      "code": "12345",
      "system": "http://example.com/codesystem",
      "display": "Example Display Name"
    }
  }'

Responses

Address replaced successfully

Bodyapplication/json
addressIdstringrequired

Canonical unique identifier for the address.

Example: "123e4567-e89b-12d3-a456-426614174000"
citystringrequired

City, town, or locality.

Example: "Sydney"
contactIdstringrequired

Identifier of the contact this address belongs to.

Example: "123e4567-e89b-12d3-a456-426614174000"
countryCodestringrequired

ISO 3166-1 alpha-2 country code when available; otherwise a system-specific country identifier.

Example: "AU"
createdAtstring(date-time)required

Timestamp when the address was created.

Example: "2025-01-01T00:00:00.000Z"
distanceobjectrequired
distance.​valuenumberrequired

Numeric value

Example: 1.5
distance.​unitstringrequired

Unit of measure

Example: "km"
distance.​systemstring

Unit system URI

Example: "http://unitsofmeasure.org"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the address is currently active/usable.

Example: true
latitudenumberrequired

Latitude in decimal degrees (WGS84).

Example: -33.8688
line1stringrequired

First line of the street address.

Example: "123 Main Street"
line2stringrequired

Second line of the street address.

Example: "Suite 100"
longitudenumberrequired

Longitude in decimal degrees (WGS84).

Example: 151.2093
namestringrequired

Optional label or name for the address (e.g., 'Home', 'Work').

Example: "Home"
postalCodestringrequired

Postal or ZIP code.

Example: "2000"
regionstringrequired

Region, province, or county.

Example: "New South Wales"
statestringrequired

State or territory (where applicable).

Example: "NSW"
suburbstringrequired

Suburb, neighborhood, or village.

Example: "Sydney"
updatedAtstring(date-time)required

Timestamp when the address was last updated.

Example: "2025-01-01T00:00:00.000Z"
countryobjectrequired
country.​codestringrequired

Code value

Example: "12345"
country.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
country.​displaystring

Human-readable display

Example: "Example Display Name"
Response
application/json
{ "addressId": "123e4567-e89b-12d3-a456-426614174000", "city": "Sydney", "contactId": "123e4567-e89b-12d3-a456-426614174000", "countryCode": "AU", "createdAt": "2025-01-01T00:00:00.000Z", "distance": { "value": 1.5, "unit": "km", "system": "http://unitsofmeasure.org" }, "extensions": {}, "isActive": true, "latitude": -33.8688, "line1": "123 Main Street", "line2": "Suite 100", "longitude": 151.2093, "name": "Home", "postalCode": "2000", "region": "New South Wales", "state": "NSW", "suburb": "Sydney", "updatedAt": "2025-01-01T00:00:00.000Z", "country": { "code": "12345", "system": "http://example.com/codesystem", "display": "Example Display Name" } }

Request

Permanently deletes a Address record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

addressIdstringrequired

Address unique identifier (UUID)

curl -i -X DELETE \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/address/{addressId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Address deleted successfully

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations