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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
abbreviationstring

Short code or abbreviation for the sex (e.g., M, F, U).

extensionsobject

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this sex option is active and should be available for selection.

isDesexedboolean

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestringrequired

Human-readable name of the sex (e.g., Male, Female, Unknown).

sexIdstringrequired

Stable, opaque identifier for the sex record.

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

Responses

Sex created successfully

Bodyapplication/json
abbreviationstringrequired

Short code or abbreviation for the sex (e.g., M, F, U).

createdAtstring(date-time)required

Timestamp when this sex record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this sex option is active and should be available for selection.

isDesexedbooleanrequired

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestringrequired

Human-readable name of the sex (e.g., Male, Female, Unknown).

sexIdstringrequired

Stable, opaque identifier for the sex record.

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

Timestamp when this sex record was last updated.

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

Request

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

Sort order

Default "asc"
Enum"asc""desc"
abbreviationstring

Short code or abbreviation for the sex (e.g., M, F, U).

isActiveboolean

Whether this sex option is active and should be available for selection.

isDesexedboolean

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestring

Human-readable name of the sex (e.g., Male, Female, Unknown).

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

Responses

Paginated list of Sexes

Request

Returns a single Sex by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

sexIdstringrequired

Sex unique identifier (UUID)

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

Responses

Sex found

Bodyapplication/json
abbreviationstringrequired

Short code or abbreviation for the sex (e.g., M, F, U).

createdAtstring(date-time)required

Timestamp when this sex record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this sex option is active and should be available for selection.

isDesexedbooleanrequired

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestringrequired

Human-readable name of the sex (e.g., Male, Female, Unknown).

sexIdstringrequired

Stable, opaque identifier for the sex record.

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

Timestamp when this sex record was last updated.

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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

sexIdstringrequired

Sex unique identifier (UUID)

Bodyapplication/jsonrequired
abbreviationstring

Short code or abbreviation for the sex (e.g., M, F, U).

extensionsobject

Vendor- or practice-specific extensions.

isActiveboolean

Whether this sex option is active and should be available for selection.

isDesexedboolean

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestring

Human-readable name of the sex (e.g., Male, Female, Unknown).

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

Responses

Sex updated successfully

Bodyapplication/json
abbreviationstringrequired

Short code or abbreviation for the sex (e.g., M, F, U).

createdAtstring(date-time)required

Timestamp when this sex record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this sex option is active and should be available for selection.

isDesexedbooleanrequired

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestringrequired

Human-readable name of the sex (e.g., Male, Female, Unknown).

sexIdstringrequired

Stable, opaque identifier for the sex record.

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

Timestamp when this sex record was last updated.

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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

sexIdstringrequired

Sex unique identifier (UUID)

Bodyapplication/jsonrequired
abbreviationstringrequired

Short code or abbreviation for the sex (e.g., M, F, U).

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this sex option is active and should be available for selection.

isDesexedbooleanrequired

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestringrequired

Human-readable name of the sex (e.g., Male, Female, Unknown).

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

Responses

Sex replaced successfully

Bodyapplication/json
abbreviationstringrequired

Short code or abbreviation for the sex (e.g., M, F, U).

createdAtstring(date-time)required

Timestamp when this sex record was created.

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

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this sex option is active and should be available for selection.

isDesexedbooleanrequired

Indicates whether this sex classification implies desexing (e.g., neutered male).

namestringrequired

Human-readable name of the sex (e.g., Male, Female, Unknown).

sexIdstringrequired

Stable, opaque identifier for the sex record.

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

Timestamp when this sex record was last updated.

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

Request

Permanently deletes a Sex record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

sexIdstringrequired

Sex unique identifier (UUID)

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

Responses

Sex 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