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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

insuranceIdstringrequired

Insurance unique identifier (UUID)

Bodyapplication/jsonrequired
policyNumberstringrequired

Insurance policy number.

providerobjectrequired
provider.​codestringrequired

Code value

provider.​systemstringrequired

Code system URI

provider.​displaystring

Human-readable display

animalIdstringrequired

Reference to the insured animal.

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

Reference to the policy holder contact.

Example: "123e4567-e89b-12d3-a456-426614174000"
coverageTypeobjectrequired
coverageType.​codestringrequired

Code value

coverageType.​systemstringrequired

Code system URI

coverageType.​displaystring

Human-readable display

effectiveDatestringrequired

Date the policy becomes effective.

Example: "2025-01-01"
expiryDatestringrequired

Date the policy expires.

Example: "2025-01-01"
isActivebooleanrequired

Whether the policy is currently active.

extensionsobjectrequired

Vendor- or practice-specific extensions.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/insurance/{insuranceId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "policyNumber": "string",
    "provider": {
      "code": "string",
      "system": "string",
      "display": "string"
    },
    "animalId": "123e4567-e89b-12d3-a456-426614174000",
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "coverageType": {
      "code": "string",
      "system": "string",
      "display": "string"
    },
    "effectiveDate": "2025-01-01",
    "expiryDate": "2025-01-01",
    "isActive": true,
    "extensions": {}
  }'

Responses

Insurance replaced successfully

Bodyapplication/json
insuranceIdstringrequired

Canonical unique identifier for the insurance record.

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

Insurance policy number.

providerobjectrequired
provider.​codestringrequired

Code value

provider.​systemstringrequired

Code system URI

provider.​displaystring

Human-readable display

animalIdstringrequired

Reference to the insured animal.

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

Reference to the policy holder contact.

Example: "123e4567-e89b-12d3-a456-426614174000"
coverageTypeobjectrequired
coverageType.​codestringrequired

Code value

coverageType.​systemstringrequired

Code system URI

coverageType.​displaystring

Human-readable display

effectiveDatestring(date-time)required

Date the policy becomes effective.

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

Date the policy expires.

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

Whether the policy is currently active.

createdAtstring(date-time)required

Timestamp when the insurance record was created.

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

Timestamp when the insurance record was last updated.

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

Vendor- or practice-specific extensions.

Response
application/json
{ "insuranceId": "123e4567-e89b-12d3-a456-426614174000", "policyNumber": "string", "provider": { "code": "string", "system": "string", "display": "string" }, "animalId": "123e4567-e89b-12d3-a456-426614174000", "contactId": "123e4567-e89b-12d3-a456-426614174000", "coverageType": { "code": "string", "system": "string", "display": "string" }, "effectiveDate": "2025-01-01T00:00:00Z", "expiryDate": "2025-01-01T00:00:00Z", "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }

Request

Permanently deletes a Insurance record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

insuranceIdstringrequired

Insurance unique identifier (UUID)

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

Responses

Insurance 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