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
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Request

Returns a single Location by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

locationIdstringrequired

Location unique identifier (UUID)

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

Responses

Location found

Bodyapplication/json
locationIdstringrequired

Canonical unique identifier for the location.

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

Human-readable name of the location.

locationTypeobjectrequired
locationType.​codestringrequired

Code value

locationType.​systemstringrequired

Code system URI

locationType.​displaystring

Human-readable display

parentLocationIdstringrequired

Reference to parent location for hierarchical structures.

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

Reference to the facility this location belongs to.

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

Physical address if applicable.

coordinatesobjectrequired

GPS coordinates.

isActivebooleanrequired

Whether the location is currently active.

createdAtstring(date-time)required

Timestamp when the location record was created.

Example: "2025-01-01T00:00:00.000Z"
updatedAtstring(date-time)required

Timestamp when the location record was last updated.

Example: "2025-01-01T00:00:00.000Z"
extensionsobjectrequired

Vendor- or practice-specific extensions.

Response
application/json
{ "locationId": "123e4567-e89b-12d3-a456-426614174000", "name": "string", "locationType": { "code": "string", "system": "string", "display": "string" }, "parentLocationId": "123e4567-e89b-12d3-a456-426614174000", "facilityId": "123e4567-e89b-12d3-a456-426614174000", "address": {}, "coordinates": {}, "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }

Request

Partially updates an existing Location. Only provided fields will be updated.

Security
bearer
Path
siteIdnumberrequired

Site identifier

locationIdstringrequired

Location unique identifier (UUID)

Bodyapplication/jsonrequired
namestring

Human-readable name of the location.

locationTypeobject
parentLocationIdstring

Reference to parent location for hierarchical structures.

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

Reference to the facility this location belongs to.

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

Physical address if applicable.

coordinatesobject

GPS coordinates.

isActiveboolean

Whether the location is currently active.

extensionsobject

Vendor- or practice-specific extensions.

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/location/{locationId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "locationType": {
      "code": "string",
      "system": "string",
      "display": "string"
    },
    "parentLocationId": "123e4567-e89b-12d3-a456-426614174000",
    "facilityId": "123e4567-e89b-12d3-a456-426614174000",
    "address": {},
    "coordinates": {},
    "isActive": true,
    "extensions": {}
  }'

Responses

Location updated successfully

Bodyapplication/json
locationIdstringrequired

Canonical unique identifier for the location.

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

Human-readable name of the location.

locationTypeobjectrequired
locationType.​codestringrequired

Code value

locationType.​systemstringrequired

Code system URI

locationType.​displaystring

Human-readable display

parentLocationIdstringrequired

Reference to parent location for hierarchical structures.

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

Reference to the facility this location belongs to.

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

Physical address if applicable.

coordinatesobjectrequired

GPS coordinates.

isActivebooleanrequired

Whether the location is currently active.

createdAtstring(date-time)required

Timestamp when the location record was created.

Example: "2025-01-01T00:00:00.000Z"
updatedAtstring(date-time)required

Timestamp when the location record was last updated.

Example: "2025-01-01T00:00:00.000Z"
extensionsobjectrequired

Vendor- or practice-specific extensions.

Response
application/json
{ "locationId": "123e4567-e89b-12d3-a456-426614174000", "name": "string", "locationType": { "code": "string", "system": "string", "display": "string" }, "parentLocationId": "123e4567-e89b-12d3-a456-426614174000", "facilityId": "123e4567-e89b-12d3-a456-426614174000", "address": {}, "coordinates": {}, "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

locationIdstringrequired

Location unique identifier (UUID)

Bodyapplication/jsonrequired
namestringrequired

Human-readable name of the location.

locationTypeobjectrequired
locationType.​codestringrequired

Code value

locationType.​systemstringrequired

Code system URI

locationType.​displaystring

Human-readable display

parentLocationIdstringrequired

Reference to parent location for hierarchical structures.

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

Reference to the facility this location belongs to.

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

Physical address if applicable.

coordinatesobjectrequired

GPS coordinates.

isActivebooleanrequired

Whether the location is currently active.

extensionsobjectrequired

Vendor- or practice-specific extensions.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/location/{locationId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "locationType": {
      "code": "string",
      "system": "string",
      "display": "string"
    },
    "parentLocationId": "123e4567-e89b-12d3-a456-426614174000",
    "facilityId": "123e4567-e89b-12d3-a456-426614174000",
    "address": {},
    "coordinates": {},
    "isActive": true,
    "extensions": {}
  }'

Responses

Location replaced successfully

Bodyapplication/json
locationIdstringrequired

Canonical unique identifier for the location.

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

Human-readable name of the location.

locationTypeobjectrequired
locationType.​codestringrequired

Code value

locationType.​systemstringrequired

Code system URI

locationType.​displaystring

Human-readable display

parentLocationIdstringrequired

Reference to parent location for hierarchical structures.

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

Reference to the facility this location belongs to.

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

Physical address if applicable.

coordinatesobjectrequired

GPS coordinates.

isActivebooleanrequired

Whether the location is currently active.

createdAtstring(date-time)required

Timestamp when the location record was created.

Example: "2025-01-01T00:00:00.000Z"
updatedAtstring(date-time)required

Timestamp when the location record was last updated.

Example: "2025-01-01T00:00:00.000Z"
extensionsobjectrequired

Vendor- or practice-specific extensions.

Response
application/json
{ "locationId": "123e4567-e89b-12d3-a456-426614174000", "name": "string", "locationType": { "code": "string", "system": "string", "display": "string" }, "parentLocationId": "123e4567-e89b-12d3-a456-426614174000", "facilityId": "123e4567-e89b-12d3-a456-426614174000", "address": {}, "coordinates": {}, "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations