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

Fully replaces an existing Product. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productIdstringrequired

Product unique identifier (UUID)

Bodyapplication/jsonrequired
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"
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"
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"
warningstringrequired

Warning or caution text associated with the product.

Example: "example"
curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/product/{productId}' \
  -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",
    "productType": "standard",
    "sheetGroupId": "123e4567-e89b-12d3-a456-426614174000",
    "sheetGroupName": "Example Name",
    "stockLevel": {},
    "trackingLevel": "none",
    "warning": "example"
  }'

Responses

Product replaced 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

Permanently deletes a Product record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productIdstringrequired

Product unique identifier (UUID)

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

Responses

Product deleted successfully

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations