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

Security
bearer
Path
siteIdnumberrequired

Site identifier

Bodyapplication/jsonrequired
codestring

Practice-specific short code or identifier for the user.

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

Human-readable display name for the user.

Example: "Example Name"
extensionsobject

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the user is active and can be used in workflows.

Example: true
isSalespersonboolean

Whether the user is a salesperson.

Example: true
isVeterinarianboolean

Whether the user is a veterinarian.

Example: true
userIdstring

Canonical unique identifier for the user.

Example: "123e4567-e89b-12d3-a456-426614174000"
curl -i -X POST \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/user' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "123e4567-e89b-12d3-a456-426614174000",
    "displayName": "Example Name",
    "extensions": {},
    "isActive": true,
    "isSalesperson": true,
    "isVeterinarian": true,
    "userId": "123e4567-e89b-12d3-a456-426614174000"
  }'

Responses

User created successfully

Bodyapplication/json
codestringrequired

Practice-specific short code or identifier for the user.

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

Timestamp when the user record was created.

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

Human-readable display name for the user.

Example: "Example Name"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the user is active and can be used in workflows.

Example: true
isSalespersonbooleanrequired

Whether the user is a salesperson.

Example: true
isVeterinarianbooleanrequired

Whether the user is a veterinarian.

Example: true
updatedAtstring(date-time)required

Timestamp when the user record was last updated.

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

Canonical unique identifier for the user.

Example: "123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{ "code": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "displayName": "Example Name", "extensions": {}, "isActive": true, "isSalesperson": true, "isVeterinarian": true, "updatedAt": "2025-01-01T00:00:00.000Z", "userId": "123e4567-e89b-12d3-a456-426614174000" }

Request

Returns a paginated list of Users 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""code""displayName"
sortOrderstring

Sort order

Default "asc"
Enum"asc""desc"
codestring

Practice-specific short code or identifier for the user.

displayNamestring

Human-readable display name for the user.

isActiveboolean

Whether the user is active and can be used in workflows.

isSalespersonboolean

Whether the user is a salesperson.

isVeterinarianboolean

Whether the user is a veterinarian.

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

Responses

Paginated list of Users

Request

Returns a single User by its unique identifier.

Security
bearer
Path
siteIdnumberrequired

Site identifier

userIdstringrequired

User unique identifier (UUID)

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

Responses

User found

Bodyapplication/json
codestringrequired

Practice-specific short code or identifier for the user.

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

Timestamp when the user record was created.

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

Human-readable display name for the user.

Example: "Example Name"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether the user is active and can be used in workflows.

Example: true
isSalespersonbooleanrequired

Whether the user is a salesperson.

Example: true
isVeterinarianbooleanrequired

Whether the user is a veterinarian.

Example: true
updatedAtstring(date-time)required

Timestamp when the user record was last updated.

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

Canonical unique identifier for the user.

Example: "123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{ "code": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "displayName": "Example Name", "extensions": {}, "isActive": true, "isSalesperson": true, "isVeterinarian": true, "updatedAt": "2025-01-01T00:00:00.000Z", "userId": "123e4567-e89b-12d3-a456-426614174000" }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations