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

Request

Fully replaces an existing Diagnostic Request. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

diagnosticRequestIdstringrequired

Diagnostic Request unique identifier (UUID)

Bodyapplication/jsonrequired
animalIdstringrequired

Animal for which the diagnostics are requested.

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

Consult/visit associated with this diagnostic request.

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

Owner or client contact associated with the request.

Example: "123e4567-e89b-12d3-a456-426614174000"
diagnosticItemsArray of objects(DiagnosticItemDto)required

List of individual diagnostics requested as part of this request.

diagnosticItems[].​codestring

Practice or supplier-specific code for the diagnostic test.

diagnosticItems[].​createdAtstring

When this diagnostic item was created.

Example: "2025-01-01T00:00:00.000Z"
diagnosticItems[].​diagnosticClassstring

Category or class of the diagnostic test.

diagnosticItems[].​diagnosticIdstringrequired

Reference to the catalog diagnostic/test being requested.

Example: "123e4567-e89b-12d3-a456-426614174000"
diagnosticItems[].​diagnosticRequestItemIdstringrequired

Canonical identifier for this diagnostic request item.

Example: "123e4567-e89b-12d3-a456-426614174000"
diagnosticItems[].​isActiveboolean

Whether this diagnostic item is currently active.

diagnosticItems[].​namestring

Human-readable name of the diagnostic test.

diagnosticItems[].​updatedAtstring

When this diagnostic item was last updated.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the diagnostic request is currently active.

ownershipIdstringrequired

Ownership or billing entity associated with the request.

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

External or practice-specific reference number for the diagnostic request.

requestedAtstringrequired

Business timestamp associated with the diagnostic request (e.g., when it was requested).

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

Free-text details or instructions for the diagnostic request.

statusstringrequired

Status of the diagnostic request.

Enum"draft""requested""in-progress""completed""cancelled""entered-in-error""unknown"
supplierIdstringrequired

External laboratory or supplier handling the diagnostics.

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

Veterinarian responsible for the diagnostic request.

Example: "123e4567-e89b-12d3-a456-426614174000"
curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/diagnostic-request/{diagnosticRequestId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "animalId": "123e4567-e89b-12d3-a456-426614174000",
    "consultId": "123e4567-e89b-12d3-a456-426614174000",
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "diagnosticItems": [
      {
        "code": "string",
        "createdAt": "2025-01-01T00:00:00.000Z",
        "diagnosticClass": "string",
        "diagnosticId": "123e4567-e89b-12d3-a456-426614174000",
        "diagnosticRequestItemId": "123e4567-e89b-12d3-a456-426614174000",
        "isActive": true,
        "name": "string",
        "updatedAt": "2025-01-01T00:00:00.000Z"
      }
    ],
    "extensions": {},
    "isActive": true,
    "ownershipId": "123e4567-e89b-12d3-a456-426614174000",
    "referenceNumber": "string",
    "requestedAt": "2025-01-01T00:00:00.000Z",
    "specifics": "string",
    "status": "draft",
    "supplierId": "123e4567-e89b-12d3-a456-426614174000",
    "vetId": "123e4567-e89b-12d3-a456-426614174000"
  }'

Responses

Diagnostic Request replaced successfully

Bodyapplication/json
animalIdstringrequired

Animal for which the diagnostics are requested.

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

Consult/visit associated with this diagnostic request.

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

Owner or client contact associated with the request.

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

When the diagnostic request was created.

Example: "2025-01-01T00:00:00.000Z"
diagnosticItemsArray of objects(DiagnosticItemDto)required

List of individual diagnostics requested as part of this request.

diagnosticItems[].​codestring

Practice or supplier-specific code for the diagnostic test.

diagnosticItems[].​createdAtstring

When this diagnostic item was created.

Example: "2025-01-01T00:00:00.000Z"
diagnosticItems[].​diagnosticClassstring

Category or class of the diagnostic test.

diagnosticItems[].​diagnosticIdstringrequired

Reference to the catalog diagnostic/test being requested.

Example: "123e4567-e89b-12d3-a456-426614174000"
diagnosticItems[].​diagnosticRequestItemIdstringrequired

Canonical identifier for this diagnostic request item.

Example: "123e4567-e89b-12d3-a456-426614174000"
diagnosticItems[].​isActiveboolean

Whether this diagnostic item is currently active.

diagnosticItems[].​namestring

Human-readable name of the diagnostic test.

diagnosticItems[].​updatedAtstring

When this diagnostic item was last updated.

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

Canonical identifier for the diagnostic request.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the diagnostic request is currently active.

ownershipIdstringrequired

Ownership or billing entity associated with the request.

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

External or practice-specific reference number for the diagnostic request.

requestedAtstring(date-time)required

Business timestamp associated with the diagnostic request (e.g., when it was requested).

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

Free-text details or instructions for the diagnostic request.

statusstringrequired

Status of the diagnostic request.

Enum"draft""requested""in-progress""completed""cancelled""entered-in-error""unknown"
supplierIdstringrequired

External laboratory or supplier handling the diagnostics.

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

When the diagnostic request was last updated.

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

Veterinarian responsible for the diagnostic request.

Example: "123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{ "animalId": "123e4567-e89b-12d3-a456-426614174000", "consultId": "123e4567-e89b-12d3-a456-426614174000", "contactId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "diagnosticItems": [ { … } ], "diagnosticRequestId": "123e4567-e89b-12d3-a456-426614174000", "extensions": {}, "isActive": true, "ownershipId": "123e4567-e89b-12d3-a456-426614174000", "referenceNumber": "string", "requestedAt": "2025-01-01T00:00:00.000Z", "specifics": "string", "status": "draft", "supplierId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z", "vetId": "123e4567-e89b-12d3-a456-426614174000" }

Request

Permanently deletes a Diagnostic Request record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

diagnosticRequestIdstringrequired

Diagnostic Request unique identifier (UUID)

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

Responses

Diagnostic Request 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
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