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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
extensionsobject

Vendor- or practice-specific extensions to the canonical SiteInformation resource.

practiceTypestringrequired

Free-text description of the practice type.

prefixstringrequired

Short code or subdomain prefix used to identify the site in URLs or integrations.

siteInformationIdstringrequired

Canonical identifier for the site.g. 'site_jkjBWPng4gFTqRxYkomWU').

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

Timezone configuration for the site.

versionnumberrequired

System or schema version associated with the site.

curl -i -X POST \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/site-information' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {},
    "practiceType": "string",
    "prefix": "string",
    "siteInformationId": "123e4567-e89b-12d3-a456-426614174000",
    "timezone": {},
    "version": 0
  }'

Responses

Site Information created successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the site record was created in the AHDS system.

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

Vendor- or practice-specific extensions to the canonical SiteInformation resource.

practiceTypestringrequired

Free-text description of the practice type.

prefixstringrequired

Short code or subdomain prefix used to identify the site in URLs or integrations.

siteInformationIdstringrequired

Canonical identifier for the site.g. 'site_jkjBWPng4gFTqRxYkomWU').

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

Timezone configuration for the site.

updatedAtstring(date-time)required

Timestamp when the site record was last updated in the AHDS system.

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

System or schema version associated with the site.

Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "practiceType": "string", "prefix": "string", "siteInformationId": "123e4567-e89b-12d3-a456-426614174000", "timezone": {}, "updatedAt": "2025-01-01T00:00:00.000Z", "version": 0 }

Request

Returns a paginated list of Site Informations 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""practiceType""prefix""version"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
practiceTypestring

Free-text description of the practice type.

prefixstring

Short code or subdomain prefix used to identify the site in URLs or integrations.

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

Responses

Paginated list of Site Informations

Request

Returns a single Site Information by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

siteInformationIdstringrequired

Site Information unique identifier (UUID)

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

Responses

Site Information found

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the site record was created in the AHDS system.

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

Vendor- or practice-specific extensions to the canonical SiteInformation resource.

practiceTypestringrequired

Free-text description of the practice type.

prefixstringrequired

Short code or subdomain prefix used to identify the site in URLs or integrations.

siteInformationIdstringrequired

Canonical identifier for the site.g. 'site_jkjBWPng4gFTqRxYkomWU').

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

Timezone configuration for the site.

updatedAtstring(date-time)required

Timestamp when the site record was last updated in the AHDS system.

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

System or schema version associated with the site.

Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "practiceType": "string", "prefix": "string", "siteInformationId": "123e4567-e89b-12d3-a456-426614174000", "timezone": {}, "updatedAt": "2025-01-01T00:00:00.000Z", "version": 0 }

Request

Partially updates an existing Site Information. Only provided fields will be updated.

Security
bearer
Path
siteIdnumberrequired

Site identifier

siteInformationIdstringrequired

Site Information unique identifier (UUID)

Bodyapplication/jsonrequired
extensionsobject

Vendor- or practice-specific extensions to the canonical SiteInformation resource.

practiceTypestring

Free-text description of the practice type.

prefixstring

Short code or subdomain prefix used to identify the site in URLs or integrations.

timezoneobject

Timezone configuration for the site.

versionnumber

System or schema version associated with the site.

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/site-information/{siteInformationId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {},
    "practiceType": "string",
    "prefix": "string",
    "timezone": {},
    "version": 0
  }'

Responses

Site Information updated successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the site record was created in the AHDS system.

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

Vendor- or practice-specific extensions to the canonical SiteInformation resource.

practiceTypestringrequired

Free-text description of the practice type.

prefixstringrequired

Short code or subdomain prefix used to identify the site in URLs or integrations.

siteInformationIdstringrequired

Canonical identifier for the site.g. 'site_jkjBWPng4gFTqRxYkomWU').

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

Timezone configuration for the site.

updatedAtstring(date-time)required

Timestamp when the site record was last updated in the AHDS system.

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

System or schema version associated with the site.

Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "practiceType": "string", "prefix": "string", "siteInformationId": "123e4567-e89b-12d3-a456-426614174000", "timezone": {}, "updatedAt": "2025-01-01T00:00:00.000Z", "version": 0 }

Request

Fully replaces an existing Site Information. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

siteInformationIdstringrequired

Site Information unique identifier (UUID)

Bodyapplication/jsonrequired
extensionsobjectrequired

Vendor- or practice-specific extensions to the canonical SiteInformation resource.

practiceTypestringrequired

Free-text description of the practice type.

prefixstringrequired

Short code or subdomain prefix used to identify the site in URLs or integrations.

timezoneobjectrequired

Timezone configuration for the site.

versionnumberrequired

System or schema version associated with the site.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/site-information/{siteInformationId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {},
    "practiceType": "string",
    "prefix": "string",
    "timezone": {},
    "version": 0
  }'

Responses

Site Information replaced successfully

Bodyapplication/json
createdAtstring(date-time)required

Timestamp when the site record was created in the AHDS system.

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

Vendor- or practice-specific extensions to the canonical SiteInformation resource.

practiceTypestringrequired

Free-text description of the practice type.

prefixstringrequired

Short code or subdomain prefix used to identify the site in URLs or integrations.

siteInformationIdstringrequired

Canonical identifier for the site.g. 'site_jkjBWPng4gFTqRxYkomWU').

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

Timezone configuration for the site.

updatedAtstring(date-time)required

Timestamp when the site record was last updated in the AHDS system.

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

System or schema version associated with the site.

Response
application/json
{ "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "practiceType": "string", "prefix": "string", "siteInformationId": "123e4567-e89b-12d3-a456-426614174000", "timezone": {}, "updatedAt": "2025-01-01T00:00:00.000Z", "version": 0 }

Request

Permanently deletes a Site Information record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

siteInformationIdstringrequired

Site Information unique identifier (UUID)

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

Responses

Site Information deleted successfully

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations