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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
codestringrequired

Practice- or system-specific code for the modality (e.g., 'XR', 'US').

Example: "CODE-001"
descriptionstring or null

Optional description of the modality.

Example: "Example description"
extensionsobject

Vendor- or practice-specific extension fields.

isActiveboolean

Indicates whether this modality is active and can be used.

Example: true
modalityIdstring

Canonical unique identifier for the modality.

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

Human-readable name of the modality.

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

Responses

Modality created successfully

Bodyapplication/json
codestringrequired

Practice- or system-specific code for the modality (e.g., 'XR', 'US').

Example: "CODE-001"
descriptionstring or nullrequired

Optional description of the modality.

Example: "Example description"
extensionsobjectrequired

Vendor- or practice-specific extension fields.

isActivebooleanrequired

Indicates whether this modality is active and can be used.

Example: true
modalityIdstringrequired

Canonical unique identifier for the modality.

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

Human-readable name of the modality.

Example: "Example Name"
Response
application/json
{ "code": "CODE-001", "description": "Example description", "extensions": {}, "isActive": true, "modalityId": "123e4567-e89b-12d3-a456-426614174000", "name": "Example Name" }

Request

Returns a paginated list of Modalities 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"code""description""name"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
codestring

Practice- or system-specific code for the modality (e.g., 'XR', 'US').

descriptionstring

Optional description of the modality.

isActiveboolean

Indicates whether this modality is active and can be used.

namestring

Human-readable name of the modality.

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

Responses

Paginated list of Modalities

Request

Returns a single Modality by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

modalityIdstringrequired

Modality unique identifier (UUID)

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

Responses

Modality found

Bodyapplication/json
codestringrequired

Practice- or system-specific code for the modality (e.g., 'XR', 'US').

Example: "CODE-001"
descriptionstring or nullrequired

Optional description of the modality.

Example: "Example description"
extensionsobjectrequired

Vendor- or practice-specific extension fields.

isActivebooleanrequired

Indicates whether this modality is active and can be used.

Example: true
modalityIdstringrequired

Canonical unique identifier for the modality.

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

Human-readable name of the modality.

Example: "Example Name"
Response
application/json
{ "code": "CODE-001", "description": "Example description", "extensions": {}, "isActive": true, "modalityId": "123e4567-e89b-12d3-a456-426614174000", "name": "Example Name" }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations