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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

speciesIdstringrequired

Species unique identifier (UUID)

Bodyapplication/jsonrequired
codeobject
extensionsobject

Vendor- or practice-specific extensions.

isActiveboolean

Whether this species is active and can be used in the system.

Example: true
namestring

Human-readable species name (e.g., 'Canine', 'Feline').

Example: "Example Name"
aliasesArray of strings

Optional list of alternative names or synonyms for this species (e.g., common names, abbreviations).

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/species/{speciesId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": {
      "code": "12345",
      "system": "http://example.com/codesystem",
      "display": "Example Display Name"
    },
    "extensions": {},
    "isActive": true,
    "name": "Example Name",
    "aliases": [
      "string"
    ]
  }'

Responses

Species updated successfully

Bodyapplication/json
codeobjectrequired
code.​codestringrequired

Code value

Example: "12345"
code.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
code.​displaystring

Human-readable display

Example: "Example Display Name"
createdAtstring(date-time)required

Timestamp when the species record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this species is active and can be used in the system.

Example: true
namestringrequired

Human-readable species name (e.g., 'Canine', 'Feline').

Example: "Example Name"
speciesIdstringrequired

Canonical unique identifier for the species.

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

Timestamp when the species record was last updated.

Example: "2025-01-01T00:00:00.000Z"
aliasesArray of stringsrequired

Optional list of alternative names or synonyms for this species (e.g., common names, abbreviations).

Response
application/json
{ "code": { "code": "12345", "system": "http://example.com/codesystem", "display": "Example Display Name" }, "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "Example Name", "speciesId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z", "aliases": [ "string" ] }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

speciesIdstringrequired

Species unique identifier (UUID)

Bodyapplication/jsonrequired
codeobjectrequired
code.​codestringrequired

Code value

Example: "12345"
code.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
code.​displaystring

Human-readable display

Example: "Example Display Name"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this species is active and can be used in the system.

Example: true
namestringrequired

Human-readable species name (e.g., 'Canine', 'Feline').

Example: "Example Name"
aliasesArray of stringsrequired

Optional list of alternative names or synonyms for this species (e.g., common names, abbreviations).

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/species/{speciesId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": {
      "code": "12345",
      "system": "http://example.com/codesystem",
      "display": "Example Display Name"
    },
    "extensions": {},
    "isActive": true,
    "name": "Example Name",
    "aliases": [
      "string"
    ]
  }'

Responses

Species replaced successfully

Bodyapplication/json
codeobjectrequired
code.​codestringrequired

Code value

Example: "12345"
code.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
code.​displaystring

Human-readable display

Example: "Example Display Name"
createdAtstring(date-time)required

Timestamp when the species record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this species is active and can be used in the system.

Example: true
namestringrequired

Human-readable species name (e.g., 'Canine', 'Feline').

Example: "Example Name"
speciesIdstringrequired

Canonical unique identifier for the species.

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

Timestamp when the species record was last updated.

Example: "2025-01-01T00:00:00.000Z"
aliasesArray of stringsrequired

Optional list of alternative names or synonyms for this species (e.g., common names, abbreviations).

Response
application/json
{ "code": { "code": "12345", "system": "http://example.com/codesystem", "display": "Example Display Name" }, "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "Example Name", "speciesId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z", "aliases": [ "string" ] }

Request

Permanently deletes a Species record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

speciesIdstringrequired

Species unique identifier (UUID)

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

Responses

Species 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