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

Request

Creates a new Animal Colour record. Animal Colour resource in the Animal Health Data Store

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
animalColourIdstring

Canonical identifier for the animal colour.

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

Vendor- or practice-specific extensions.

isActiveboolean

Whether this colour is active and selectable in the system.

namestringrequired

Human-readable name of the animal colour (e.g., 'Black', 'Chestnut').

curl -i -X POST \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/animal-colour' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "animalColourId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "name": "string"
  }'

Responses

Animal Colour created successfully

Bodyapplication/json
animalColourIdstringrequired

Canonical identifier for the animal colour.

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

Timestamp when this colour record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this colour is active and selectable in the system.

namestringrequired

Human-readable name of the animal colour (e.g., 'Black', 'Chestnut').

updatedAtstring(date-time)required

Timestamp when this colour record was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "animalColourId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "string", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Returns a paginated list of Animal Colours 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""name"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
isActiveboolean

Whether this colour is active and selectable in the system.

namestring

Human-readable name of the animal colour (e.g., 'Black', 'Chestnut').

curl -i -X GET \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/animal-colour?page=0&pageSize=10&sortBy=createdAt&sortOrder=asc&isActive=true&name=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Paginated list of Animal Colours

Request

Returns a single Animal Colour by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

animalColourIdstringrequired

Animal Colour unique identifier (UUID)

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

Responses

Animal Colour found

Bodyapplication/json
animalColourIdstringrequired

Canonical identifier for the animal colour.

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

Timestamp when this colour record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this colour is active and selectable in the system.

namestringrequired

Human-readable name of the animal colour (e.g., 'Black', 'Chestnut').

updatedAtstring(date-time)required

Timestamp when this colour record was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "animalColourId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "string", "updatedAt": "2025-01-01T00:00:00.000Z" }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations