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

Request

Returns a paginated list of Species 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 species is active and can be used in the system.

namestring

Human-readable species name (e.g., 'Canine', 'Feline').

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

Responses

Paginated list of Species

Request

Returns a single Species by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

speciesIdstringrequired

Species unique identifier (UUID)

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

Responses

Species found

Bodyapplication/json
codeobjectrequired
code.​codestringrequired

Code value

Example: "12345"
code.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
code.​displaystring

Human-readable display

Example: "Example Display Name"
createdAtstring(date-time)required

Timestamp when the species record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this species is active and can be used in the system.

Example: true
namestringrequired

Human-readable species name (e.g., 'Canine', 'Feline').

Example: "Example Name"
speciesIdstringrequired

Canonical unique identifier for the species.

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

Timestamp when the species record was last updated.

Example: "2025-01-01T00:00:00.000Z"
aliasesArray of stringsrequired

Optional list of alternative names or synonyms for this species (e.g., common names, abbreviations).

Response
application/json
{ "code": { "code": "12345", "system": "http://example.com/codesystem", "display": "Example Display Name" }, "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "Example Name", "speciesId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z", "aliases": [ "string" ] }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

speciesIdstringrequired

Species unique identifier (UUID)

Bodyapplication/jsonrequired
codeobject
extensionsobject

Vendor- or practice-specific extensions.

isActiveboolean

Whether this species is active and can be used in the system.

Example: true
namestring

Human-readable species name (e.g., 'Canine', 'Feline').

Example: "Example Name"
aliasesArray of strings

Optional list of alternative names or synonyms for this species (e.g., common names, abbreviations).

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/species/{speciesId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": {
      "code": "12345",
      "system": "http://example.com/codesystem",
      "display": "Example Display Name"
    },
    "extensions": {},
    "isActive": true,
    "name": "Example Name",
    "aliases": [
      "string"
    ]
  }'

Responses

Species updated successfully

Bodyapplication/json
codeobjectrequired
code.​codestringrequired

Code value

Example: "12345"
code.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
code.​displaystring

Human-readable display

Example: "Example Display Name"
createdAtstring(date-time)required

Timestamp when the species record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this species is active and can be used in the system.

Example: true
namestringrequired

Human-readable species name (e.g., 'Canine', 'Feline').

Example: "Example Name"
speciesIdstringrequired

Canonical unique identifier for the species.

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

Timestamp when the species record was last updated.

Example: "2025-01-01T00:00:00.000Z"
aliasesArray of stringsrequired

Optional list of alternative names or synonyms for this species (e.g., common names, abbreviations).

Response
application/json
{ "code": { "code": "12345", "system": "http://example.com/codesystem", "display": "Example Display Name" }, "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "Example Name", "speciesId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z", "aliases": [ "string" ] }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations