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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

herdIdstringrequired

Herd unique identifier (UUID)

Bodyapplication/jsonrequired
namestringrequired

Human-readable name or identifier for the herd.

herdTypeobjectrequired
herdType.​codestringrequired

Code value

herdType.​systemstringrequired

Code system URI

herdType.​displaystring

Human-readable display

ownerIdstringrequired

Reference to the contact who owns this herd.

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

Reference to the primary location where the herd is kept.

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

Estimated number of animals in the herd.

isActivebooleanrequired

Whether the herd 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/herd/{herdId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "herdType": {
      "code": "string",
      "system": "string",
      "display": "string"
    },
    "ownerId": "123e4567-e89b-12d3-a456-426614174000",
    "locationId": "123e4567-e89b-12d3-a456-426614174000",
    "estimatedCount": 0,
    "isActive": true,
    "extensions": {}
  }'

Responses

Herd replaced successfully

Bodyapplication/json
herdIdstringrequired

Canonical unique identifier for the herd.

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

Human-readable name or identifier for the herd.

herdTypeobjectrequired
herdType.​codestringrequired

Code value

herdType.​systemstringrequired

Code system URI

herdType.​displaystring

Human-readable display

ownerIdstringrequired

Reference to the contact who owns this herd.

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

Reference to the primary location where the herd is kept.

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

Estimated number of animals in the herd.

isActivebooleanrequired

Whether the herd is currently active.

createdAtstring(date-time)required

Timestamp when the herd record was created.

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

Timestamp when the herd record was last updated.

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

Vendor- or practice-specific extensions.

Response
application/json
{ "herdId": "123e4567-e89b-12d3-a456-426614174000", "name": "string", "herdType": { "code": "string", "system": "string", "display": "string" }, "ownerId": "123e4567-e89b-12d3-a456-426614174000", "locationId": "123e4567-e89b-12d3-a456-426614174000", "estimatedCount": 0, "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }

Request

Permanently deletes a Herd record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

herdIdstringrequired

Herd unique identifier (UUID)

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

Responses

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