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

Request

Returns a single Practitioner by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

practitionerIdstringrequired

Practitioner unique identifier (UUID)

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

Responses

Practitioner found

Bodyapplication/json
practitionerIdstringrequired

Canonical unique identifier for the practitioner.

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

Reference to the associated user account.

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

Professional license number.

licenseStatestringrequired

State/jurisdiction of license.

roleobjectrequired
role.​codestringrequired

Code value

role.​systemstringrequired

Code system URI

role.​displaystring

Human-readable display

specialtiesArray of objects(SpecialtieDto)required

List of specialties (surgery, dentistry, oncology).

specialties[].​codestringrequired
specialties[].​systemstringrequired
specialties[].​displaystring
facilityIdsArray of stringsrequired

Facilities where this practitioner works.

isActivebooleanrequired

Whether the practitioner is currently active.

createdAtstring(date-time)required

Timestamp when the practitioner record was created.

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

Timestamp when the practitioner record was last updated.

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

Vendor- or practice-specific extensions.

Response
application/json
{ "practitionerId": "123e4567-e89b-12d3-a456-426614174000", "userId": "123e4567-e89b-12d3-a456-426614174000", "licenseNumber": "string", "licenseState": "string", "role": { "code": "string", "system": "string", "display": "string" }, "specialties": [ { … } ], "facilityIds": [ "string" ], "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

practitionerIdstringrequired

Practitioner unique identifier (UUID)

Bodyapplication/jsonrequired
userIdstring

Reference to the associated user account.

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

Professional license number.

licenseStatestring

State/jurisdiction of license.

roleobject
specialtiesArray of objects(SpecialtieDto)

List of specialties (surgery, dentistry, oncology).

facilityIdsArray of strings

Facilities where this practitioner works.

isActiveboolean

Whether the practitioner is currently active.

extensionsobject

Vendor- or practice-specific extensions.

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/practitioner/{practitionerId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "licenseNumber": "string",
    "licenseState": "string",
    "role": {
      "code": "string",
      "system": "string",
      "display": "string"
    },
    "specialties": [
      {
        "code": "string",
        "system": "string",
        "display": "string"
      }
    ],
    "facilityIds": [
      "string"
    ],
    "isActive": true,
    "extensions": {}
  }'

Responses

Practitioner updated successfully

Bodyapplication/json
practitionerIdstringrequired

Canonical unique identifier for the practitioner.

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

Reference to the associated user account.

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

Professional license number.

licenseStatestringrequired

State/jurisdiction of license.

roleobjectrequired
role.​codestringrequired

Code value

role.​systemstringrequired

Code system URI

role.​displaystring

Human-readable display

specialtiesArray of objects(SpecialtieDto)required

List of specialties (surgery, dentistry, oncology).

specialties[].​codestringrequired
specialties[].​systemstringrequired
specialties[].​displaystring
facilityIdsArray of stringsrequired

Facilities where this practitioner works.

isActivebooleanrequired

Whether the practitioner is currently active.

createdAtstring(date-time)required

Timestamp when the practitioner record was created.

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

Timestamp when the practitioner record was last updated.

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

Vendor- or practice-specific extensions.

Response
application/json
{ "practitionerId": "123e4567-e89b-12d3-a456-426614174000", "userId": "123e4567-e89b-12d3-a456-426614174000", "licenseNumber": "string", "licenseState": "string", "role": { "code": "string", "system": "string", "display": "string" }, "specialties": [ { … } ], "facilityIds": [ "string" ], "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

practitionerIdstringrequired

Practitioner unique identifier (UUID)

Bodyapplication/jsonrequired
userIdstringrequired

Reference to the associated user account.

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

Professional license number.

licenseStatestringrequired

State/jurisdiction of license.

roleobjectrequired
role.​codestringrequired

Code value

role.​systemstringrequired

Code system URI

role.​displaystring

Human-readable display

specialtiesArray of objects(SpecialtieDto)required

List of specialties (surgery, dentistry, oncology).

specialties[].​codestringrequired
specialties[].​systemstringrequired
specialties[].​displaystring
facilityIdsArray of stringsrequired

Facilities where this practitioner works.

isActivebooleanrequired

Whether the practitioner 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/practitioner/{practitionerId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "licenseNumber": "string",
    "licenseState": "string",
    "role": {
      "code": "string",
      "system": "string",
      "display": "string"
    },
    "specialties": [
      {
        "code": "string",
        "system": "string",
        "display": "string"
      }
    ],
    "facilityIds": [
      "string"
    ],
    "isActive": true,
    "extensions": {}
  }'

Responses

Practitioner replaced successfully

Bodyapplication/json
practitionerIdstringrequired

Canonical unique identifier for the practitioner.

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

Reference to the associated user account.

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

Professional license number.

licenseStatestringrequired

State/jurisdiction of license.

roleobjectrequired
role.​codestringrequired

Code value

role.​systemstringrequired

Code system URI

role.​displaystring

Human-readable display

specialtiesArray of objects(SpecialtieDto)required

List of specialties (surgery, dentistry, oncology).

specialties[].​codestringrequired
specialties[].​systemstringrequired
specialties[].​displaystring
facilityIdsArray of stringsrequired

Facilities where this practitioner works.

isActivebooleanrequired

Whether the practitioner is currently active.

createdAtstring(date-time)required

Timestamp when the practitioner record was created.

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

Timestamp when the practitioner record was last updated.

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

Vendor- or practice-specific extensions.

Response
application/json
{ "practitionerId": "123e4567-e89b-12d3-a456-426614174000", "userId": "123e4567-e89b-12d3-a456-426614174000", "licenseNumber": "string", "licenseState": "string", "role": { "code": "string", "system": "string", "display": "string" }, "specialties": [ { … } ], "facilityIds": [ "string" ], "isActive": true, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-01T00:00:00.000Z", "extensions": {} }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations