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.

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.

distanceobjectrequired
distance.​valuenumberrequired

Numeric value

distance.​unitstringrequired

Unit of measure

distance.​systemstring

Unit system URI

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the address is currently active/usable.

latitudenumberrequired

Latitude in decimal degrees (WGS84).

line1stringrequired

First line of the street address.

line2stringrequired

Second line of the street address.

longitudenumberrequired

Longitude in decimal degrees (WGS84).

namestringrequired

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

postalCodestringrequired

Postal or ZIP code.

regionstringrequired

Region, province, or county.

statestringrequired

State or territory (where applicable).

suburbstringrequired

Suburb, neighborhood, or village.

countryobjectrequired
country.​codestringrequired

Code value

country.​systemstringrequired

Code system URI

country.​displaystring

Human-readable display

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": "string",
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "countryCode": "string",
    "distance": {
      "value": 0,
      "unit": "string",
      "system": "string"
    },
    "extensions": {},
    "isActive": true,
    "latitude": 0,
    "line1": "string",
    "line2": "string",
    "longitude": 0,
    "name": "string",
    "postalCode": "string",
    "region": "string",
    "state": "string",
    "suburb": "string",
    "country": {
      "code": "string",
      "system": "string",
      "display": "string"
    }
  }'

Responses

Address replaced successfully

Bodyapplication/json
addressIdstringrequired

Canonical unique identifier for the address.

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

City, town, or locality.

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.

createdAtstring(date-time)required

Timestamp when the address was created.

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

Numeric value

distance.​unitstringrequired

Unit of measure

distance.​systemstring

Unit system URI

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the address is currently active/usable.

latitudenumberrequired

Latitude in decimal degrees (WGS84).

line1stringrequired

First line of the street address.

line2stringrequired

Second line of the street address.

longitudenumberrequired

Longitude in decimal degrees (WGS84).

namestringrequired

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

postalCodestringrequired

Postal or ZIP code.

regionstringrequired

Region, province, or county.

statestringrequired

State or territory (where applicable).

suburbstringrequired

Suburb, neighborhood, or village.

updatedAtstring(date-time)required

Timestamp when the address was last updated.

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

Code value

country.​systemstringrequired

Code system URI

country.​displaystring

Human-readable display

Response
application/json
{ "addressId": "123e4567-e89b-12d3-a456-426614174000", "city": "string", "contactId": "123e4567-e89b-12d3-a456-426614174000", "countryCode": "string", "createdAt": "2025-01-01T00:00:00.000Z", "distance": { "value": 0, "unit": "string", "system": "string" }, "extensions": {}, "isActive": true, "latitude": 0, "line1": "string", "line2": "string", "longitude": 0, "name": "string", "postalCode": "string", "region": "string", "state": "string", "suburb": "string", "updatedAt": "2025-01-01T00:00:00.000Z", "country": { "code": "string", "system": "string", "display": "string" } }

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