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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
codestring

Practice-specific product code or SKU.

Example: "CODE-001"
concentrationnumber

Concentration value of the product (e.g., 50 for 50 mg/mL).

Example: 1.23
concentrationDilutednumber

Concentration value after dilution, if applicable.

Example: 1.23
concentrationDilutedUnitstring

Unit of measure for the diluted concentration numerator.

Example: "example"
concentrationDilutedVolumestring

Volume unit for the diluted concentration denominator.

Example: "example"
concentrationUnitstring

Unit of measure for the concentration numerator (e.g., mg).

Example: "example"
concentrationVolumestring

Volume unit for the concentration denominator (e.g., mL).

Example: "example"
defaultDosageCalculationMethodstring

Default method used to calculate dosage (e.g., perKg, perAnimal).

Example: "example"
defaultInfusionRatePerstring

Default infusion rate basis (e.g., perHour, perDay).

Example: "example"
defaultRouteOfAdministrationstring

Default route of administration (e.g., oral, IV, IM).

Example: "example"
descriptionstring

Detailed description of the product.

Example: "Example description"
extensionsobject

Vendor- or practice-specific extensions.

hasCostPriceboolean

Whether the product has a direct cost price configured.

Example: true
isActivebooleanrequired

Whether the product is active and available for use.

Example: true
isConstantRateInfusionboolean

Whether the product is typically administered as a constant rate infusion.

Example: true
isContainerboolean

Whether the product is a container for other products.

Example: true
isDerivedPriceboolean

Whether the product price is derived from other configuration.

Example: true
isPurchasedboolean

Whether the product can be purchased from suppliers.

Example: true
isSoldboolean

Whether the product can be sold to clients.

Example: true
lowestDispensableQuantitynumber

Smallest quantity that can be dispensed.

Example: 1.23
lowestDispensableUnitstring

Unit for the lowest dispensable quantity (e.g., tablet, mL).

Example: "example"
namestringrequired

Human-readable product name.

Example: "Example Name"
productGroupIdstring

Identifier of the product group/category this product belongs to.

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

Canonical stable identifier for the product.

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

Type/category of product.

Enum"standard""medication""vaccination""diagnostic""integratedDiagnostic""procedure"
Example: "standard"
sheetGroupIdstring

Identifier of the sheet/group this product belongs to.

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

Human-readable name of the sheet/group.

Example: "Example Name"
stockLevelobject

Aggregated stock level information for this product.

trackingLevelstring

Inventory tracking level for this product.

Enum"none""product""batch"
Example: "none"
warningstring

Warning or caution text associated with the product.

Example: "example"
curl -i -X POST \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/product' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "CODE-001",
    "concentration": 1.23,
    "concentrationDiluted": 1.23,
    "concentrationDilutedUnit": "example",
    "concentrationDilutedVolume": "example",
    "concentrationUnit": "example",
    "concentrationVolume": "example",
    "defaultDosageCalculationMethod": "example",
    "defaultInfusionRatePer": "example",
    "defaultRouteOfAdministration": "example",
    "description": "Example description",
    "extensions": {},
    "hasCostPrice": true,
    "isActive": true,
    "isConstantRateInfusion": true,
    "isContainer": true,
    "isDerivedPrice": true,
    "isPurchased": true,
    "isSold": true,
    "lowestDispensableQuantity": 1.23,
    "lowestDispensableUnit": "example",
    "name": "Example Name",
    "productGroupId": "123e4567-e89b-12d3-a456-426614174000",
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "productType": "standard",
    "sheetGroupId": "123e4567-e89b-12d3-a456-426614174000",
    "sheetGroupName": "Example Name",
    "stockLevel": {},
    "trackingLevel": "none",
    "warning": "example"
  }'

Responses

Product created successfully

Bodyapplication/json
codestringrequired

Practice-specific product code or SKU.

Example: "CODE-001"
concentrationnumberrequired

Concentration value of the product (e.g., 50 for 50 mg/mL).

Example: 1.23
concentrationDilutednumberrequired

Concentration value after dilution, if applicable.

Example: 1.23
concentrationDilutedUnitstringrequired

Unit of measure for the diluted concentration numerator.

Example: "example"
concentrationDilutedVolumestringrequired

Volume unit for the diluted concentration denominator.

Example: "example"
concentrationUnitstringrequired

Unit of measure for the concentration numerator (e.g., mg).

Example: "example"
concentrationVolumestringrequired

Volume unit for the concentration denominator (e.g., mL).

Example: "example"
createdAtstring(date-time)required

Timestamp when the product was created.

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

Default method used to calculate dosage (e.g., perKg, perAnimal).

Example: "example"
defaultInfusionRatePerstringrequired

Default infusion rate basis (e.g., perHour, perDay).

Example: "example"
defaultRouteOfAdministrationstringrequired

Default route of administration (e.g., oral, IV, IM).

Example: "example"
descriptionstringrequired

Detailed description of the product.

Example: "Example description"
extensionsobjectrequired

Vendor- or practice-specific extensions.

hasCostPricebooleanrequired

Whether the product has a direct cost price configured.

Example: true
isActivebooleanrequired

Whether the product is active and available for use.

Example: true
isConstantRateInfusionbooleanrequired

Whether the product is typically administered as a constant rate infusion.

Example: true
isContainerbooleanrequired

Whether the product is a container for other products.

Example: true
isDerivedPricebooleanrequired

Whether the product price is derived from other configuration.

Example: true
isPurchasedbooleanrequired

Whether the product can be purchased from suppliers.

Example: true
isSoldbooleanrequired

Whether the product can be sold to clients.

Example: true
lowestDispensableQuantitynumberrequired

Smallest quantity that can be dispensed.

Example: 1.23
lowestDispensableUnitstringrequired

Unit for the lowest dispensable quantity (e.g., tablet, mL).

Example: "example"
namestringrequired

Human-readable product name.

Example: "Example Name"
productGroupIdstringrequired

Identifier of the product group/category this product belongs to.

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

Canonical stable identifier for the product.

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

Type/category of product.

Enum"standard""medication""vaccination""diagnostic""integratedDiagnostic""procedure"
Example: "standard"
sheetGroupIdstringrequired

Identifier of the sheet/group this product belongs to.

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

Human-readable name of the sheet/group.

Example: "Example Name"
stockLevelobjectrequired

Aggregated stock level information for this product.

trackingLevelstringrequired

Inventory tracking level for this product.

Enum"none""product""batch"
Example: "none"
updatedAtstring(date-time)required

Timestamp when the product was last modified.

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

Warning or caution text associated with the product.

Example: "example"
Response
application/json
{ "code": "CODE-001", "concentration": 1.23, "concentrationDiluted": 1.23, "concentrationDilutedUnit": "example", "concentrationDilutedVolume": "example", "concentrationUnit": "example", "concentrationVolume": "example", "createdAt": "2025-01-01T00:00:00.000Z", "defaultDosageCalculationMethod": "example", "defaultInfusionRatePer": "example", "defaultRouteOfAdministration": "example", "description": "Example description", "extensions": {}, "hasCostPrice": true, "isActive": true, "isConstantRateInfusion": true, "isContainer": true, "isDerivedPrice": true, "isPurchased": true, "isSold": true, "lowestDispensableQuantity": 1.23, "lowestDispensableUnit": "example", "name": "Example Name", "productGroupId": "123e4567-e89b-12d3-a456-426614174000", "productId": "123e4567-e89b-12d3-a456-426614174000", "productType": "standard", "sheetGroupId": "123e4567-e89b-12d3-a456-426614174000", "sheetGroupName": "Example Name", "stockLevel": {}, "trackingLevel": "none", "updatedAt": "2025-01-01T00:00:00.000Z", "warning": "example" }

Request

Returns a paginated list of Products 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""code""concentration""concentrationDiluted""concentrationDilutedUnit""concentrationDilutedVolume""concentrationUnit""concentrationVolume""defaultDosageCalculationMethod"
sortOrderstring

Sort order

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

Practice-specific product code or SKU.

concentrationDilutedUnitstring

Unit of measure for the diluted concentration numerator.

concentrationDilutedVolumestring

Volume unit for the diluted concentration denominator.

concentrationUnitstring

Unit of measure for the concentration numerator (e.g., mg).

concentrationVolumestring

Volume unit for the concentration denominator (e.g., mL).

defaultDosageCalculationMethodstring

Default method used to calculate dosage (e.g., perKg, perAnimal).

defaultInfusionRatePerstring

Default infusion rate basis (e.g., perHour, perDay).

defaultRouteOfAdministrationstring

Default route of administration (e.g., oral, IV, IM).

descriptionstring

Detailed description of the product.

hasCostPriceboolean

Whether the product has a direct cost price configured.

isActiveboolean

Whether the product is active and available for use.

isConstantRateInfusionboolean

Whether the product is typically administered as a constant rate infusion.

isContainerboolean

Whether the product is a container for other products.

isDerivedPriceboolean

Whether the product price is derived from other configuration.

isPurchasedboolean

Whether the product can be purchased from suppliers.

isSoldboolean

Whether the product can be sold to clients.

lowestDispensableUnitstring

Unit for the lowest dispensable quantity (e.g., tablet, mL).

namestring

Human-readable product name.

productGroupIdstring

Identifier of the product group/category this product belongs to.

Example: productGroupId=123e4567-e89b-12d3-a456-426614174000
productTypestring

Type/category of product.

Enum"standard""medication""vaccination""diagnostic""integratedDiagnostic""procedure"
sheetGroupIdstring

Identifier of the sheet/group this product belongs to.

Example: sheetGroupId=123e4567-e89b-12d3-a456-426614174000
sheetGroupNamestring

Human-readable name of the sheet/group.

trackingLevelstring

Inventory tracking level for this product.

Enum"none""product""batch"
warningstring

Warning or caution text associated with the product.

curl -i -X GET \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/product?page=0&pageSize=10&sortBy=createdAt&sortOrder=asc&code=string&concentrationDilutedUnit=string&concentrationDilutedVolume=string&concentrationUnit=string&concentrationVolume=string&defaultDosageCalculationMethod=string&defaultInfusionRatePer=string&defaultRouteOfAdministration=string&description=string&hasCostPrice=true&isActive=true&isConstantRateInfusion=true&isContainer=true&isDerivedPrice=true&isPurchased=true&isSold=true&lowestDispensableUnit=string&name=string&productGroupId=123e4567-e89b-12d3-a456-426614174000&productType=standard&sheetGroupId=123e4567-e89b-12d3-a456-426614174000&sheetGroupName=string&trackingLevel=none&warning=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Paginated list of Products

Request

Returns a single Product by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productIdstringrequired

Product unique identifier (UUID)

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

Responses

Product found

Bodyapplication/json
codestringrequired

Practice-specific product code or SKU.

Example: "CODE-001"
concentrationnumberrequired

Concentration value of the product (e.g., 50 for 50 mg/mL).

Example: 1.23
concentrationDilutednumberrequired

Concentration value after dilution, if applicable.

Example: 1.23
concentrationDilutedUnitstringrequired

Unit of measure for the diluted concentration numerator.

Example: "example"
concentrationDilutedVolumestringrequired

Volume unit for the diluted concentration denominator.

Example: "example"
concentrationUnitstringrequired

Unit of measure for the concentration numerator (e.g., mg).

Example: "example"
concentrationVolumestringrequired

Volume unit for the concentration denominator (e.g., mL).

Example: "example"
createdAtstring(date-time)required

Timestamp when the product was created.

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

Default method used to calculate dosage (e.g., perKg, perAnimal).

Example: "example"
defaultInfusionRatePerstringrequired

Default infusion rate basis (e.g., perHour, perDay).

Example: "example"
defaultRouteOfAdministrationstringrequired

Default route of administration (e.g., oral, IV, IM).

Example: "example"
descriptionstringrequired

Detailed description of the product.

Example: "Example description"
extensionsobjectrequired

Vendor- or practice-specific extensions.

hasCostPricebooleanrequired

Whether the product has a direct cost price configured.

Example: true
isActivebooleanrequired

Whether the product is active and available for use.

Example: true
isConstantRateInfusionbooleanrequired

Whether the product is typically administered as a constant rate infusion.

Example: true
isContainerbooleanrequired

Whether the product is a container for other products.

Example: true
isDerivedPricebooleanrequired

Whether the product price is derived from other configuration.

Example: true
isPurchasedbooleanrequired

Whether the product can be purchased from suppliers.

Example: true
isSoldbooleanrequired

Whether the product can be sold to clients.

Example: true
lowestDispensableQuantitynumberrequired

Smallest quantity that can be dispensed.

Example: 1.23
lowestDispensableUnitstringrequired

Unit for the lowest dispensable quantity (e.g., tablet, mL).

Example: "example"
namestringrequired

Human-readable product name.

Example: "Example Name"
productGroupIdstringrequired

Identifier of the product group/category this product belongs to.

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

Canonical stable identifier for the product.

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

Type/category of product.

Enum"standard""medication""vaccination""diagnostic""integratedDiagnostic""procedure"
Example: "standard"
sheetGroupIdstringrequired

Identifier of the sheet/group this product belongs to.

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

Human-readable name of the sheet/group.

Example: "Example Name"
stockLevelobjectrequired

Aggregated stock level information for this product.

trackingLevelstringrequired

Inventory tracking level for this product.

Enum"none""product""batch"
Example: "none"
updatedAtstring(date-time)required

Timestamp when the product was last modified.

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

Warning or caution text associated with the product.

Example: "example"
Response
application/json
{ "code": "CODE-001", "concentration": 1.23, "concentrationDiluted": 1.23, "concentrationDilutedUnit": "example", "concentrationDilutedVolume": "example", "concentrationUnit": "example", "concentrationVolume": "example", "createdAt": "2025-01-01T00:00:00.000Z", "defaultDosageCalculationMethod": "example", "defaultInfusionRatePer": "example", "defaultRouteOfAdministration": "example", "description": "Example description", "extensions": {}, "hasCostPrice": true, "isActive": true, "isConstantRateInfusion": true, "isContainer": true, "isDerivedPrice": true, "isPurchased": true, "isSold": true, "lowestDispensableQuantity": 1.23, "lowestDispensableUnit": "example", "name": "Example Name", "productGroupId": "123e4567-e89b-12d3-a456-426614174000", "productId": "123e4567-e89b-12d3-a456-426614174000", "productType": "standard", "sheetGroupId": "123e4567-e89b-12d3-a456-426614174000", "sheetGroupName": "Example Name", "stockLevel": {}, "trackingLevel": "none", "updatedAt": "2025-01-01T00:00:00.000Z", "warning": "example" }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations