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

Request

Returns a paginated list of Plans for the specified site. Supports filtering and sorting.

Security
bearer
Path
siteIdnumberrequired

Site identifier

Query
pagenumber>= 0

Page number (0-indexed)

Default 0
pageSizenumber[ 1 .. 100 ]

Number of items per page

Default 10
sortBystring

Field to sort by

Enum"createdAt""updatedAt""notes""recordedAt"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
animalIdstring

Identifier of the animal this plan is for.

Example: animalId=123e4567-e89b-12d3-a456-426614174000
consultIdstring

Identifier of the consult associated with this plan.

Example: consultId=123e4567-e89b-12d3-a456-426614174000
isActiveboolean

Whether the plan is currently active.

notesstring

Free-text notes describing the plan.

vetIdstring

Identifier of the veterinarian responsible for this plan.

Example: vetId=123e4567-e89b-12d3-a456-426614174000
curl -i -X GET \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/plan?page=0&pageSize=10&sortBy=createdAt&sortOrder=asc&animalId=123e4567-e89b-12d3-a456-426614174000&consultId=123e4567-e89b-12d3-a456-426614174000&isActive=true&notes=string&vetId=123e4567-e89b-12d3-a456-426614174000' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Paginated list of Plans

Request

Returns a single Plan by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

planIdstringrequired

Plan unique identifier (UUID)

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

Responses

Plan found

Bodyapplication/json
animalIdstringrequired

Identifier of the animal this plan is for.

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

Identifier of the consult associated with this plan.

Example: "123e4567-e89b-12d3-a456-426614174000"
createdAtstring(date-time)required

Timestamp when the plan was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the plan is currently active.

notesstringrequired

Free-text notes describing the plan.

planIdstringrequired

Canonical identifier for the plan.

Example: "123e4567-e89b-12d3-a456-426614174000"
recordedAtstring(date-time)required

Clinical timestamp associated with the plan (e.g., when it was recorded in the consult).

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

Timestamp when the plan was last modified.

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

Identifier of the veterinarian responsible for this plan.

Example: "123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{ "animalId": "123e4567-e89b-12d3-a456-426614174000", "consultId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "notes": "string", "planId": "123e4567-e89b-12d3-a456-426614174000", "recordedAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "vetId": "123e4567-e89b-12d3-a456-426614174000" }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

planIdstringrequired

Plan unique identifier (UUID)

Bodyapplication/jsonrequired
animalIdstring

Identifier of the animal this plan is for.

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

Identifier of the consult associated with this plan.

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

Vendor- or practice-specific extensions.

isActiveboolean

Whether the plan is currently active.

notesstring

Free-text notes describing the plan.

recordedAtstring

Clinical timestamp associated with the plan (e.g., when it was recorded in the consult).

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

Identifier of the veterinarian responsible for this plan.

Example: "123e4567-e89b-12d3-a456-426614174000"
curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/plan/{planId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "animalId": "123e4567-e89b-12d3-a456-426614174000",
    "consultId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "notes": "string",
    "recordedAt": "2025-01-01T00:00:00.000Z",
    "vetId": "123e4567-e89b-12d3-a456-426614174000"
  }'

Responses

Plan updated successfully

Bodyapplication/json
animalIdstringrequired

Identifier of the animal this plan is for.

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

Identifier of the consult associated with this plan.

Example: "123e4567-e89b-12d3-a456-426614174000"
createdAtstring(date-time)required

Timestamp when the plan was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the plan is currently active.

notesstringrequired

Free-text notes describing the plan.

planIdstringrequired

Canonical identifier for the plan.

Example: "123e4567-e89b-12d3-a456-426614174000"
recordedAtstring(date-time)required

Clinical timestamp associated with the plan (e.g., when it was recorded in the consult).

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

Timestamp when the plan was last modified.

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

Identifier of the veterinarian responsible for this plan.

Example: "123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{ "animalId": "123e4567-e89b-12d3-a456-426614174000", "consultId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "notes": "string", "planId": "123e4567-e89b-12d3-a456-426614174000", "recordedAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "vetId": "123e4567-e89b-12d3-a456-426614174000" }
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