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

Request

Returns a single Supplied by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

suppliedIdstringrequired

Supplied unique identifier (UUID)

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

Responses

Supplied found

Bodyapplication/json
batchNumberstringrequired

Batch or lot number associated with the supplied product.

Example: "example"
clientProvidedIdstringrequired

Optional client-supplied identifier for this supplied record.

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

Timestamp when this record was created in the source system.

Example: "2025-01-01T00:00:00.000Z"
expiryDatestring(date-time)required

Expiry date of the supplied batch, if applicable.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether this supplied record is active (not fully reversed or deleted).

Example: true
locationIdstringrequired

Inventory location or store where the product was supplied.

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

Free-text notes about this supplied record.

Example: "Example description"
productIdstringrequired

Reference to the product that was supplied.

Example: "123e4567-e89b-12d3-a456-426614174000"
quantityobjectrequired
quantity.​valuenumberrequired

Numeric value

Example: 1.5
quantity.​unitstringrequired

Unit of measure

Example: "km"
quantity.​systemstring

Unit system URI

Example: "http://unitsofmeasure.org"
referenceNumberstringrequired

External reference such as supplier invoice number or delivery note.

Example: "Example description"
suppliedAtstring(date-time)required

Date and time when the product was supplied/received into inventory.

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

Canonical identifier for this supplied inventory record.

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

Reference to the supplier providing the product.

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

Total cost for this supplied line (quantity × unitCost).

unitCostobjectrequired

Cost per unit of the supplied product.

updatedAtstring(date-time)required

Timestamp when this record was last updated in the source system.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "batchNumber": "example", "clientProvidedId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "expiryDate": "2025-01-01T00:00:00Z", "extensions": {}, "isActive": true, "locationId": "123e4567-e89b-12d3-a456-426614174000", "notes": "Example description", "productId": "123e4567-e89b-12d3-a456-426614174000", "quantity": { "value": 1.5, "unit": "km", "system": "http://unitsofmeasure.org" }, "referenceNumber": "Example description", "suppliedAt": "2025-01-01T00:00:00.000Z", "suppliedId": "123e4567-e89b-12d3-a456-426614174000", "supplierId": "123e4567-e89b-12d3-a456-426614174000", "totalCost": {}, "unitCost": {}, "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

suppliedIdstringrequired

Supplied unique identifier (UUID)

Bodyapplication/jsonrequired
batchNumberstring

Batch or lot number associated with the supplied product.

Example: "example"
clientProvidedIdstring

Optional client-supplied identifier for this supplied record.

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

Expiry date of the supplied batch, if applicable.

Example: "2025-01-01"
extensionsobject

Vendor- or practice-specific extensions.

isActiveboolean

Indicates whether this supplied record is active (not fully reversed or deleted).

Example: true
locationIdstring

Inventory location or store where the product was supplied.

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

Free-text notes about this supplied record.

Example: "Example description"
productIdstring

Reference to the product that was supplied.

Example: "123e4567-e89b-12d3-a456-426614174000"
quantityobject
referenceNumberstring

External reference such as supplier invoice number or delivery note.

Example: "Example description"
suppliedAtstring

Date and time when the product was supplied/received into inventory.

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

Reference to the supplier providing the product.

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

Total cost for this supplied line (quantity × unitCost).

unitCostobject

Cost per unit of the supplied product.

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/supplied/{suppliedId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "batchNumber": "example",
    "clientProvidedId": "123e4567-e89b-12d3-a456-426614174000",
    "expiryDate": "2025-01-01",
    "extensions": {},
    "isActive": true,
    "locationId": "123e4567-e89b-12d3-a456-426614174000",
    "notes": "Example description",
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "quantity": {
      "value": 1.5,
      "unit": "km",
      "system": "http://unitsofmeasure.org"
    },
    "referenceNumber": "Example description",
    "suppliedAt": "2025-01-01T00:00:00.000Z",
    "supplierId": "123e4567-e89b-12d3-a456-426614174000",
    "totalCost": {},
    "unitCost": {}
  }'

Responses

Supplied updated successfully

Bodyapplication/json
batchNumberstringrequired

Batch or lot number associated with the supplied product.

Example: "example"
clientProvidedIdstringrequired

Optional client-supplied identifier for this supplied record.

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

Timestamp when this record was created in the source system.

Example: "2025-01-01T00:00:00.000Z"
expiryDatestring(date-time)required

Expiry date of the supplied batch, if applicable.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether this supplied record is active (not fully reversed or deleted).

Example: true
locationIdstringrequired

Inventory location or store where the product was supplied.

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

Free-text notes about this supplied record.

Example: "Example description"
productIdstringrequired

Reference to the product that was supplied.

Example: "123e4567-e89b-12d3-a456-426614174000"
quantityobjectrequired
quantity.​valuenumberrequired

Numeric value

Example: 1.5
quantity.​unitstringrequired

Unit of measure

Example: "km"
quantity.​systemstring

Unit system URI

Example: "http://unitsofmeasure.org"
referenceNumberstringrequired

External reference such as supplier invoice number or delivery note.

Example: "Example description"
suppliedAtstring(date-time)required

Date and time when the product was supplied/received into inventory.

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

Canonical identifier for this supplied inventory record.

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

Reference to the supplier providing the product.

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

Total cost for this supplied line (quantity × unitCost).

unitCostobjectrequired

Cost per unit of the supplied product.

updatedAtstring(date-time)required

Timestamp when this record was last updated in the source system.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "batchNumber": "example", "clientProvidedId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "expiryDate": "2025-01-01T00:00:00Z", "extensions": {}, "isActive": true, "locationId": "123e4567-e89b-12d3-a456-426614174000", "notes": "Example description", "productId": "123e4567-e89b-12d3-a456-426614174000", "quantity": { "value": 1.5, "unit": "km", "system": "http://unitsofmeasure.org" }, "referenceNumber": "Example description", "suppliedAt": "2025-01-01T00:00:00.000Z", "suppliedId": "123e4567-e89b-12d3-a456-426614174000", "supplierId": "123e4567-e89b-12d3-a456-426614174000", "totalCost": {}, "unitCost": {}, "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

suppliedIdstringrequired

Supplied unique identifier (UUID)

Bodyapplication/jsonrequired
batchNumberstringrequired

Batch or lot number associated with the supplied product.

Example: "example"
clientProvidedIdstringrequired

Optional client-supplied identifier for this supplied record.

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

Expiry date of the supplied batch, if applicable.

Example: "2025-01-01"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether this supplied record is active (not fully reversed or deleted).

Example: true
locationIdstringrequired

Inventory location or store where the product was supplied.

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

Free-text notes about this supplied record.

Example: "Example description"
productIdstringrequired

Reference to the product that was supplied.

Example: "123e4567-e89b-12d3-a456-426614174000"
quantityobjectrequired
quantity.​valuenumberrequired

Numeric value

Example: 1.5
quantity.​unitstringrequired

Unit of measure

Example: "km"
quantity.​systemstring

Unit system URI

Example: "http://unitsofmeasure.org"
referenceNumberstringrequired

External reference such as supplier invoice number or delivery note.

Example: "Example description"
suppliedAtstringrequired

Date and time when the product was supplied/received into inventory.

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

Reference to the supplier providing the product.

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

Total cost for this supplied line (quantity × unitCost).

unitCostobjectrequired

Cost per unit of the supplied product.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/supplied/{suppliedId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "batchNumber": "example",
    "clientProvidedId": "123e4567-e89b-12d3-a456-426614174000",
    "expiryDate": "2025-01-01",
    "extensions": {},
    "isActive": true,
    "locationId": "123e4567-e89b-12d3-a456-426614174000",
    "notes": "Example description",
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "quantity": {
      "value": 1.5,
      "unit": "km",
      "system": "http://unitsofmeasure.org"
    },
    "referenceNumber": "Example description",
    "suppliedAt": "2025-01-01T00:00:00.000Z",
    "supplierId": "123e4567-e89b-12d3-a456-426614174000",
    "totalCost": {},
    "unitCost": {}
  }'

Responses

Supplied replaced successfully

Bodyapplication/json
batchNumberstringrequired

Batch or lot number associated with the supplied product.

Example: "example"
clientProvidedIdstringrequired

Optional client-supplied identifier for this supplied record.

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

Timestamp when this record was created in the source system.

Example: "2025-01-01T00:00:00.000Z"
expiryDatestring(date-time)required

Expiry date of the supplied batch, if applicable.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether this supplied record is active (not fully reversed or deleted).

Example: true
locationIdstringrequired

Inventory location or store where the product was supplied.

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

Free-text notes about this supplied record.

Example: "Example description"
productIdstringrequired

Reference to the product that was supplied.

Example: "123e4567-e89b-12d3-a456-426614174000"
quantityobjectrequired
quantity.​valuenumberrequired

Numeric value

Example: 1.5
quantity.​unitstringrequired

Unit of measure

Example: "km"
quantity.​systemstring

Unit system URI

Example: "http://unitsofmeasure.org"
referenceNumberstringrequired

External reference such as supplier invoice number or delivery note.

Example: "Example description"
suppliedAtstring(date-time)required

Date and time when the product was supplied/received into inventory.

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

Canonical identifier for this supplied inventory record.

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

Reference to the supplier providing the product.

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

Total cost for this supplied line (quantity × unitCost).

unitCostobjectrequired

Cost per unit of the supplied product.

updatedAtstring(date-time)required

Timestamp when this record was last updated in the source system.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "batchNumber": "example", "clientProvidedId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "expiryDate": "2025-01-01T00:00:00Z", "extensions": {}, "isActive": true, "locationId": "123e4567-e89b-12d3-a456-426614174000", "notes": "Example description", "productId": "123e4567-e89b-12d3-a456-426614174000", "quantity": { "value": 1.5, "unit": "km", "system": "http://unitsofmeasure.org" }, "referenceNumber": "Example description", "suppliedAt": "2025-01-01T00:00:00.000Z", "suppliedId": "123e4567-e89b-12d3-a456-426614174000", "supplierId": "123e4567-e89b-12d3-a456-426614174000", "totalCost": {}, "unitCost": {}, "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