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

Request

Fully replaces an existing Shelter Animal Booking. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

shelterAnimalBookingIdstringrequired

Shelter Animal Booking unique identifier (UUID)

Bodyapplication/jsonrequired
animalIdstringrequired

Reference to the animal associated with this booking.

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

Free-text notes about the booking.

consultIdstring or null

Optional reference to a related consult/visit.

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

Reference to the primary contact associated with this booking (e.g., adopter, foster, organization).

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

End date and time of the booking.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this booking is currently active.

shelterResourceIdstringrequired

Reference to the shelter resource (e.g., kennel, run, room) being booked.

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

Human-readable name of the shelter resource at the time of booking.

shelterResourceOwnershipIdstringrequired

Reference to the ownership record of the shelter resource, if applicable.

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

Reference to the shelter place/location associated with this booking.

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

Start date and time of the booking.

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

Current status of the shelter animal booking.

Enum"planned""in-progress""completed""cancelled""no-show""on-hold""unknown"
bookingTypeobjectrequired
bookingType.​codestringrequired

Code value

bookingType.​systemstringrequired

Code system URI

bookingType.​displaystring

Human-readable display

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/shelter-animal-booking/{shelterAnimalBookingId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "animalId": "123e4567-e89b-12d3-a456-426614174000",
    "comment": "string",
    "consultId": "123e4567-e89b-12d3-a456-426614174000",
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "endAt": "2025-01-01T00:00:00.000Z",
    "extensions": {},
    "isActive": true,
    "shelterResourceId": "123e4567-e89b-12d3-a456-426614174000",
    "shelterResourceName": "string",
    "shelterResourceOwnershipId": "123e4567-e89b-12d3-a456-426614174000",
    "shelterResourcePlaceId": "123e4567-e89b-12d3-a456-426614174000",
    "startAt": "2025-01-01T00:00:00.000Z",
    "status": "planned",
    "bookingType": {
      "code": "string",
      "system": "string",
      "display": "string"
    }
  }'

Responses

Shelter Animal Booking replaced successfully

Bodyapplication/json
animalIdstringrequired

Reference to the animal associated with this booking.

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

Free-text notes about the booking.

consultIdstring or nullrequired

Optional reference to a related consult/visit.

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

Reference to the primary contact associated with this booking (e.g., adopter, foster, organization).

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

Timestamp when the booking record was created.

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

End date and time of the booking.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this booking is currently active.

shelterAnimalBookingIdstringrequired

Canonical identifier for this shelter animal booking.

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

Reference to the shelter resource (e.g., kennel, run, room) being booked.

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

Human-readable name of the shelter resource at the time of booking.

shelterResourceOwnershipIdstringrequired

Reference to the ownership record of the shelter resource, if applicable.

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

Reference to the shelter place/location associated with this booking.

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

Start date and time of the booking.

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

Current status of the shelter animal booking.

Enum"planned""in-progress""completed""cancelled""no-show""on-hold""unknown"
updatedAtstring(date-time)required

Timestamp when the booking record was last modified.

Example: "2025-01-01T00:00:00.000Z"
bookingTypeobjectrequired
bookingType.​codestringrequired

Code value

bookingType.​systemstringrequired

Code system URI

bookingType.​displaystring

Human-readable display

Response
application/json
{ "animalId": "123e4567-e89b-12d3-a456-426614174000", "comment": "string", "consultId": "123e4567-e89b-12d3-a456-426614174000", "contactId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "endAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "shelterAnimalBookingId": "123e4567-e89b-12d3-a456-426614174000", "shelterResourceId": "123e4567-e89b-12d3-a456-426614174000", "shelterResourceName": "string", "shelterResourceOwnershipId": "123e4567-e89b-12d3-a456-426614174000", "shelterResourcePlaceId": "123e4567-e89b-12d3-a456-426614174000", "startAt": "2025-01-01T00:00:00.000Z", "status": "planned", "updatedAt": "2025-01-01T00:00:00.000Z", "bookingType": { "code": "string", "system": "string", "display": "string" } }

Request

Permanently deletes a Shelter Animal Booking record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

shelterAnimalBookingIdstringrequired

Shelter Animal Booking unique identifier (UUID)

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

Responses

Shelter Animal Booking 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
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations