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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
extensionsobject

Vendor- or practice-specific extensions.

externalLinkstring

External URL associated with this requisition form (e.g., supplier portal link).

requisitionFormIdstringrequired

Canonical unique identifier for the requisition form.

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

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
curl -i -X POST \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/requisition-form' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {},
    "externalLink": "string",
    "requisitionFormId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "draft"
  }'

Responses

Requisition Form created successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the requisition form was created.

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

Vendor- or practice-specific extensions.

externalLinkstringrequired

External URL associated with this requisition form (e.g., supplier portal link).

requisitionFormIdstringrequired

Canonical unique identifier for the requisition form.

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

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
updatedAtstring(date-time)required

Timestamp when the requisition form was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "externalLink": "string", "requisitionFormId": "123e4567-e89b-12d3-a456-426614174000", "status": "draft", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Returns a paginated list of Requisition Forms 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""externalLink"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
externalLinkstring

External URL associated with this requisition form (e.g., supplier portal link).

statusstring

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
curl -i -X GET \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/requisition-form?page=0&pageSize=10&sortBy=createdAt&sortOrder=asc&externalLink=string&status=draft' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Paginated list of Requisition Forms

Request

Returns a single Requisition Form by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

requisitionFormIdstringrequired

Requisition Form unique identifier (UUID)

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

Responses

Requisition Form found

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the requisition form was created.

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

Vendor- or practice-specific extensions.

externalLinkstringrequired

External URL associated with this requisition form (e.g., supplier portal link).

requisitionFormIdstringrequired

Canonical unique identifier for the requisition form.

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

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
updatedAtstring(date-time)required

Timestamp when the requisition form was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "externalLink": "string", "requisitionFormId": "123e4567-e89b-12d3-a456-426614174000", "status": "draft", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Partially updates an existing Requisition Form. Only provided fields will be updated.

Security
bearer
Path
siteIdnumberrequired

Site identifier

requisitionFormIdstringrequired

Requisition Form unique identifier (UUID)

Bodyapplication/jsonrequired
extensionsobject

Vendor- or practice-specific extensions.

externalLinkstring

External URL associated with this requisition form (e.g., supplier portal link).

statusstring

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/requisition-form/{requisitionFormId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {},
    "externalLink": "string",
    "status": "draft"
  }'

Responses

Requisition Form updated successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the requisition form was created.

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

Vendor- or practice-specific extensions.

externalLinkstringrequired

External URL associated with this requisition form (e.g., supplier portal link).

requisitionFormIdstringrequired

Canonical unique identifier for the requisition form.

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

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
updatedAtstring(date-time)required

Timestamp when the requisition form was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "externalLink": "string", "requisitionFormId": "123e4567-e89b-12d3-a456-426614174000", "status": "draft", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Fully replaces an existing Requisition Form. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

requisitionFormIdstringrequired

Requisition Form unique identifier (UUID)

Bodyapplication/jsonrequired
extensionsobjectrequired

Vendor- or practice-specific extensions.

externalLinkstringrequired

External URL associated with this requisition form (e.g., supplier portal link).

statusstringrequired

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/requisition-form/{requisitionFormId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {},
    "externalLink": "string",
    "status": "draft"
  }'

Responses

Requisition Form replaced successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the requisition form was created.

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

Vendor- or practice-specific extensions.

externalLinkstringrequired

External URL associated with this requisition form (e.g., supplier portal link).

requisitionFormIdstringrequired

Canonical unique identifier for the requisition form.

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

Lifecycle status of the requisition form.

Enum"draft""submitted""approved""rejected""cancelled""fulfilled"
updatedAtstring(date-time)required

Timestamp when the requisition form was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "externalLink": "string", "requisitionFormId": "123e4567-e89b-12d3-a456-426614174000", "status": "draft", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Permanently deletes a Requisition Form record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

requisitionFormIdstringrequired

Requisition Form unique identifier (UUID)

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

Responses

Requisition Form 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