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 Contact Association record. Contact Association resource in the Animal Health Data Store

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
associatedContactIdstringrequired

Associated/related contact.

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

Classification of the relationship between the contacts.

Enum"family""other"
contactAssociationIdstring

Canonical identifier for this contact association.

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

Primary contact in the association.

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

Vendor- or practice-specific extension fields.

isActivebooleanrequired

Whether this association is currently active.

associationTypeobjectrequired
associationType.​codestringrequired

Code value

associationType.​systemstringrequired

Code system URI

associationType.​displaystring

Human-readable display

curl -i -X POST \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/contact-association' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "associatedContactId": "123e4567-e89b-12d3-a456-426614174000",
    "associationClass": "family",
    "contactAssociationId": "123e4567-e89b-12d3-a456-426614174000",
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "associationType": {
      "code": "string",
      "system": "string",
      "display": "string"
    }
  }'

Responses

Contact Association created successfully

Bodyapplication/json
associatedContactIdstringrequired

Associated/related contact.

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

Classification of the relationship between the contacts.

Enum"family""other"
contactAssociationIdstringrequired

Canonical identifier for this contact association.

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

Primary contact in the association.

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

Timestamp when the association was created.

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

Vendor- or practice-specific extension fields.

isActivebooleanrequired

Whether this association is currently active.

updatedAtstring(date-time)required

Timestamp when the association was last updated.

Example: "2025-01-01T00:00:00.000Z"
associationTypeobjectrequired
associationType.​codestringrequired

Code value

associationType.​systemstringrequired

Code system URI

associationType.​displaystring

Human-readable display

Response
application/json
{ "associatedContactId": "123e4567-e89b-12d3-a456-426614174000", "associationClass": "family", "contactAssociationId": "123e4567-e89b-12d3-a456-426614174000", "contactId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "updatedAt": "2025-01-01T00:00:00.000Z", "associationType": { "code": "string", "system": "string", "display": "string" } }

Request

Returns a paginated list of Contact Associations 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"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
associatedContactIdstring

Associated/related contact.

Example: associatedContactId=123e4567-e89b-12d3-a456-426614174000
associationClassstring

Classification of the relationship between the contacts.

Enum"family""other"
contactIdstring

Primary contact in the association.

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

Whether this association is currently active.

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

Responses

Paginated list of Contact Associations

Request

Returns a single Contact Association by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

contactAssociationIdstringrequired

Contact Association unique identifier (UUID)

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

Responses

Contact Association found

Bodyapplication/json
associatedContactIdstringrequired

Associated/related contact.

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

Classification of the relationship between the contacts.

Enum"family""other"
contactAssociationIdstringrequired

Canonical identifier for this contact association.

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

Primary contact in the association.

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

Timestamp when the association was created.

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

Vendor- or practice-specific extension fields.

isActivebooleanrequired

Whether this association is currently active.

updatedAtstring(date-time)required

Timestamp when the association was last updated.

Example: "2025-01-01T00:00:00.000Z"
associationTypeobjectrequired
associationType.​codestringrequired

Code value

associationType.​systemstringrequired

Code system URI

associationType.​displaystring

Human-readable display

Response
application/json
{ "associatedContactId": "123e4567-e89b-12d3-a456-426614174000", "associationClass": "family", "contactAssociationId": "123e4567-e89b-12d3-a456-426614174000", "contactId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "updatedAt": "2025-01-01T00:00:00.000Z", "associationType": { "code": "string", "system": "string", "display": "string" } }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations