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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
descriptionstring

Optional description of the product group.

extensionsobject

Vendor- or practice-specific extensions.

isActiveboolean

Whether the product group is active and can be used.

namestringrequired

Human-readable name of the product group.

productgroupIdstringrequired

Canonical unique identifier for the product group.

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

Responses

Productgroup created successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the product group was created.

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

Optional description of the product group.

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the product group is active and can be used.

namestringrequired

Human-readable name of the product group.

productgroupIdstringrequired

Canonical unique identifier for the product group.

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

Timestamp when the product group was last updated.

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

Request

Returns a paginated list of Productgroups 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""description""name"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
descriptionstring

Optional description of the product group.

isActiveboolean

Whether the product group is active and can be used.

namestring

Human-readable name of the product group.

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

Responses

Paginated list of Productgroups

Request

Returns a single Productgroup by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productgroupIdstringrequired

Productgroup unique identifier (UUID)

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

Responses

Productgroup found

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the product group was created.

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

Optional description of the product group.

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the product group is active and can be used.

namestringrequired

Human-readable name of the product group.

productgroupIdstringrequired

Canonical unique identifier for the product group.

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

Timestamp when the product group was last updated.

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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

productgroupIdstringrequired

Productgroup unique identifier (UUID)

Bodyapplication/jsonrequired
descriptionstring

Optional description of the product group.

extensionsobject

Vendor- or practice-specific extensions.

isActiveboolean

Whether the product group is active and can be used.

namestring

Human-readable name of the product group.

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/productgroup/{productgroupId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "string",
    "extensions": {},
    "isActive": true,
    "name": "string"
  }'

Responses

Productgroup updated successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the product group was created.

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

Optional description of the product group.

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the product group is active and can be used.

namestringrequired

Human-readable name of the product group.

productgroupIdstringrequired

Canonical unique identifier for the product group.

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

Timestamp when the product group was last updated.

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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

productgroupIdstringrequired

Productgroup unique identifier (UUID)

Bodyapplication/jsonrequired
descriptionstringrequired

Optional description of the product group.

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the product group is active and can be used.

namestringrequired

Human-readable name of the product group.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/productgroup/{productgroupId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "string",
    "extensions": {},
    "isActive": true,
    "name": "string"
  }'

Responses

Productgroup replaced successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the product group was created.

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

Optional description of the product group.

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the product group is active and can be used.

namestringrequired

Human-readable name of the product group.

productgroupIdstringrequired

Canonical unique identifier for the product group.

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

Timestamp when the product group was last updated.

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

Request

Permanently deletes a Productgroup record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productgroupIdstringrequired

Productgroup unique identifier (UUID)

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

Responses

Productgroup 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