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

Request

Creates a new Tagname record. Tagname resource in the Animal Health Data Store

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
categoryIdstring

Identifier of the category this tag belongs to.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the tag is currently active and usable.

namestringrequired

Human-readable name of the tag.

tagnameIdstringrequired

Canonical identifier for the tagname.

Example: "123e4567-e89b-12d3-a456-426614174000"
curl -i -X POST \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/tagname' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "categoryId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "name": "string",
    "tagnameId": "123e4567-e89b-12d3-a456-426614174000"
  }'

Responses

Tagname created successfully

Bodyapplication/json
categoryIdstringrequired

Identifier of the category this tag belongs to.

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

Timestamp when the tag was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the tag is currently active and usable.

namestringrequired

Human-readable name of the tag.

tagnameIdstringrequired

Canonical identifier for the tagname.

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

Timestamp when the tag was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "categoryId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "string", "tagnameId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Returns a paginated list of Tagnames for the specified site. Supports filtering and sorting.

Security
bearer
Path
siteIdnumberrequired

Site identifier

Query
pagenumber>= 0

Page number (0-indexed)

Default 0
pageSizenumber[ 1 .. 100 ]

Number of items per page

Default 10
sortBystring

Field to sort by

Enum"createdAt""updatedAt""name"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
categoryIdstring

Identifier of the category this tag belongs to.

Example: categoryId=123e4567-e89b-12d3-a456-426614174000
isActiveboolean

Whether the tag is currently active and usable.

namestring

Human-readable name of the tag.

curl -i -X GET \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/tagname?page=0&pageSize=10&sortBy=createdAt&sortOrder=asc&categoryId=123e4567-e89b-12d3-a456-426614174000&isActive=true&name=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Paginated list of Tagnames

Request

Returns a single Tagname by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

tagnameIdstringrequired

Tagname unique identifier (UUID)

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

Responses

Tagname found

Bodyapplication/json
categoryIdstringrequired

Identifier of the category this tag belongs to.

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

Timestamp when the tag was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the tag is currently active and usable.

namestringrequired

Human-readable name of the tag.

tagnameIdstringrequired

Canonical identifier for the tagname.

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

Timestamp when the tag was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "categoryId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "string", "tagnameId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

tagnameIdstringrequired

Tagname unique identifier (UUID)

Bodyapplication/jsonrequired
categoryIdstring

Identifier of the category this tag belongs to.

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

Vendor- or practice-specific extensions.

isActiveboolean

Whether the tag is currently active and usable.

namestring

Human-readable name of the tag.

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/tagname/{tagnameId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "categoryId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "name": "string"
  }'

Responses

Tagname updated successfully

Bodyapplication/json
categoryIdstringrequired

Identifier of the category this tag belongs to.

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

Timestamp when the tag was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the tag is currently active and usable.

namestringrequired

Human-readable name of the tag.

tagnameIdstringrequired

Canonical identifier for the tagname.

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

Timestamp when the tag was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "categoryId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "string", "tagnameId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

tagnameIdstringrequired

Tagname unique identifier (UUID)

Bodyapplication/jsonrequired
categoryIdstringrequired

Identifier of the category this tag belongs to.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the tag is currently active and usable.

namestringrequired

Human-readable name of the tag.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/tagname/{tagnameId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "categoryId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "name": "string"
  }'

Responses

Tagname replaced successfully

Bodyapplication/json
categoryIdstringrequired

Identifier of the category this tag belongs to.

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

Timestamp when the tag was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the tag is currently active and usable.

namestringrequired

Human-readable name of the tag.

tagnameIdstringrequired

Canonical identifier for the tagname.

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

Timestamp when the tag was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "categoryId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "name": "string", "tagnameId": "123e4567-e89b-12d3-a456-426614174000", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Permanently deletes a Tagname record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

tagnameIdstringrequired

Tagname unique identifier (UUID)

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

Responses

Tagname deleted successfully

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations