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

Request

Partially updates an existing Contact Detail. Only provided fields will be updated.

Security
bearer
Path
siteIdnumberrequired

Site identifier

contactDetailIdstringrequired

Contact Detail unique identifier (UUID)

Bodyapplication/jsonrequired
contactDetailTypeobject
contactIdstring

Identifier of the contact this detail belongs to.

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

Vendor- or practice-specific extensions.

isActiveboolean

Whether this contact detail is currently active.

Example: true
isPreferredboolean

Whether this is the preferred contact detail of its type for the contact.

Example: true
namestring

Label or type name for the contact detail (e.g. 'Home phone', 'Email').

Example: "Example Name"
subscriptionGroupsArray of strings

Identifiers of communication subscription groups associated with this contact detail.

valuestring

Raw value of the contact detail (e.g. phone number, email address).

Example: "user@example.com"
valueCleanedstring or null

System-normalized representation of the value, if available.

Example: "example"
curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/contact-detail/{contactDetailId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "contactDetailType": {
      "code": "12345",
      "system": "http://example.com/codesystem",
      "display": "Example Display Name"
    },
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "isPreferred": true,
    "name": "Example Name",
    "subscriptionGroups": [
      "string"
    ],
    "value": "user@example.com",
    "valueCleaned": "example"
  }'

Responses

Contact Detail updated successfully

Bodyapplication/json
contactDetailIdstringrequired

Canonical identifier for this contact detail.

Example: "123e4567-e89b-12d3-a456-426614174000"
contactDetailTypeobjectrequired
contactDetailType.​codestringrequired

Code value

Example: "12345"
contactDetailType.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
contactDetailType.​displaystring

Human-readable display

Example: "Example Display Name"
contactIdstringrequired

Identifier of the contact this detail belongs to.

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

Timestamp when this contact detail was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this contact detail is currently active.

Example: true
isPreferredbooleanrequired

Whether this is the preferred contact detail of its type for the contact.

Example: true
namestringrequired

Label or type name for the contact detail (e.g. 'Home phone', 'Email').

Example: "Example Name"
subscriptionGroupsArray of stringsrequired

Identifiers of communication subscription groups associated with this contact detail.

updatedAtstring(date-time)required

Timestamp when this contact detail was last updated.

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

Raw value of the contact detail (e.g. phone number, email address).

Example: "user@example.com"
valueCleanedstring or nullrequired

System-normalized representation of the value, if available.

Example: "example"
Response
application/json
{ "contactDetailId": "123e4567-e89b-12d3-a456-426614174000", "contactDetailType": { "code": "12345", "system": "http://example.com/codesystem", "display": "Example Display Name" }, "contactId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "isPreferred": true, "name": "Example Name", "subscriptionGroups": [ "string" ], "updatedAt": "2025-01-01T00:00:00.000Z", "value": "user@example.com", "valueCleaned": "example" }

Request

Fully replaces an existing Contact Detail. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

contactDetailIdstringrequired

Contact Detail unique identifier (UUID)

Bodyapplication/jsonrequired
contactDetailTypeobjectrequired
contactDetailType.​codestringrequired

Code value

Example: "12345"
contactDetailType.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
contactDetailType.​displaystring

Human-readable display

Example: "Example Display Name"
contactIdstringrequired

Identifier of the contact this detail belongs to.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this contact detail is currently active.

Example: true
isPreferredbooleanrequired

Whether this is the preferred contact detail of its type for the contact.

Example: true
namestringrequired

Label or type name for the contact detail (e.g. 'Home phone', 'Email').

Example: "Example Name"
subscriptionGroupsArray of stringsrequired

Identifiers of communication subscription groups associated with this contact detail.

valuestringrequired

Raw value of the contact detail (e.g. phone number, email address).

Example: "user@example.com"
valueCleanedstring or null

System-normalized representation of the value, if available.

Example: "example"
curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/contact-detail/{contactDetailId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "contactDetailType": {
      "code": "12345",
      "system": "http://example.com/codesystem",
      "display": "Example Display Name"
    },
    "contactId": "123e4567-e89b-12d3-a456-426614174000",
    "extensions": {},
    "isActive": true,
    "isPreferred": true,
    "name": "Example Name",
    "subscriptionGroups": [
      "string"
    ],
    "value": "user@example.com",
    "valueCleaned": "example"
  }'

Responses

Contact Detail replaced successfully

Bodyapplication/json
contactDetailIdstringrequired

Canonical identifier for this contact detail.

Example: "123e4567-e89b-12d3-a456-426614174000"
contactDetailTypeobjectrequired
contactDetailType.​codestringrequired

Code value

Example: "12345"
contactDetailType.​systemstringrequired

Code system URI

Example: "http://example.com/codesystem"
contactDetailType.​displaystring

Human-readable display

Example: "Example Display Name"
contactIdstringrequired

Identifier of the contact this detail belongs to.

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

Timestamp when this contact detail was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this contact detail is currently active.

Example: true
isPreferredbooleanrequired

Whether this is the preferred contact detail of its type for the contact.

Example: true
namestringrequired

Label or type name for the contact detail (e.g. 'Home phone', 'Email').

Example: "Example Name"
subscriptionGroupsArray of stringsrequired

Identifiers of communication subscription groups associated with this contact detail.

updatedAtstring(date-time)required

Timestamp when this contact detail was last updated.

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

Raw value of the contact detail (e.g. phone number, email address).

Example: "user@example.com"
valueCleanedstring or nullrequired

System-normalized representation of the value, if available.

Example: "example"
Response
application/json
{ "contactDetailId": "123e4567-e89b-12d3-a456-426614174000", "contactDetailType": { "code": "12345", "system": "http://example.com/codesystem", "display": "Example Display Name" }, "contactId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "isActive": true, "isPreferred": true, "name": "Example Name", "subscriptionGroups": [ "string" ], "updatedAt": "2025-01-01T00:00:00.000Z", "value": "user@example.com", "valueCleaned": "example" }

Request

Permanently deletes a Contact Detail record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

contactDetailIdstringrequired

Contact Detail unique identifier (UUID)

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

Responses

Contact Detail 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