Acmecompany Bizmerlin Expense Reports

Name: Expense Reports API
Brand: Expense Reports
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHR recruitingEmployee ManagementapiKey143 EndpointsREST

For Agents

Read and update HR records — timesheets, expense reports, leaves, performance reviews, goals, training, and recruiting — across a BizMerlin (ClayHR) tenant so agents can automate everyday HR operations.

Install Jentic One Beta

Connect the Expense Reports to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Expense Reports, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Expense Reports API.

Submit and approve expense reports across the employee lifecycle

Read and update timesheets and timecards for a given user

Manage leave requests, balances, and approvals

Track candidates through the recruiting pipeline including detail and list views

GET STARTED

Start building with Expense Reports API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Expense Reports API for, with concrete tasks.

★ Automated Expense Report Submission from Receipts

An expense capture tool extracts receipt data externally and pushes the result into BizMerlin as an expense report via the expense endpoints. Reviewers approve in BizMerlin while employees never re-enter values. Token plus userid headers identify the submitting employee, and custom fields capture project allocation. This compresses end-of-month expense cycles.

Create an expense report with three line items for a given employee userid, attach the receipt references, and submit for approval

Manager Leave Approval Dashboard

A manager-facing dashboard pulls pending leave requests via the leaves endpoints, presents them with employee context from the people endpoints, and writes the approval back. Managers approve from one screen instead of clicking into BizMerlin per request, and the system audit trail stays in the HR system of record.

List all pending leave requests for the manager's reports, sort by submitted date, and approve the oldest five

Recruiting Pipeline Sync to External ATS

A recruiting tool keeps candidate stages in sync between an external ATS and BizMerlin by polling /list and /detail/{recruitid} on the candidates surface. Hiring managers see the same pipeline stage in BizMerlin that recruiters see in their ATS, and offer-letter triggers can flow back into BizMerlin onboarding. This avoids duplicate data entry across the two systems.

List candidates updated in the last day and pull each candidate's full detail to compare with the ATS record

Training Rollout via an HR Assistant Bot

An HR assistant bot in Slack assigns mandatory trainings, posts announcements, and follows up on missing surveys. It calls the trainings, announcements, and survey endpoints through Jentic. Employees interact with the bot, the bot calls BizMerlin on their behalf, and the API key plus userid headers stay encrypted in the vault.

Through Jentic, search 'assign a training to employees', load the trainings endpoint schema, and assign a security-awareness training to a list of userids

Key Endpoints

143 endpoints — jentic publishes the only available openapi specification for this bizmerlin hr (clayhr) tenant api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/api/token

Obtain a tenant API token

GET

/list

List candidate records

GET

/detail/{recruitid}

Retrieve candidate detail by id

POST

/api/announcement/create

Create a company announcement

GET

/api/announcement/{annId}

Retrieve an announcement

PUT

/api/announcement/edit

Edit an existing announcement

GET

/customfield

Read custom field values

GET

/api/token

Obtain a tenant API token

GET

/list

List candidate records

GET

/detail/{recruitid}

Retrieve candidate detail by id

POST

/api/announcement/create

Create a company announcement

GET

/api/announcement/{annId}

Retrieve an announcement

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

BizMerlin x-api-key and userid header values are stored encrypted in the Jentic vault. Jentic injects both headers at execution time so the raw values never enter agent context.

Intent-based discovery

Agents search by intent — for example, 'submit an expense report' — and Jentic returns the relevant BizMerlin endpoint with its schema and the required header parameters.

Time to first call

Direct integration: 1-2 weeks given 143 endpoints, dual-header auth, and tenant-specific custom fields. Through Jentic: under 1 hour for the first working call against the tenant.

FAQs

Specific to using Expense Reports API through Jentic.

Why is there no official OpenAPI spec for Expense Reports?

BizMerlin (ClayHR) does not publish a public OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Expense Reports via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the BizMerlin (ClayHR) API use?

Two API key headers — x-api-key for the tenant key and userid for the acting employee — on every request. Through Jentic, both values are stored encrypted in the vault and injected per call so the raw values stay out of agent context.

Can I submit and approve expense reports through this API?

Yes. The API exposes endpoints across the expense report lifecycle — creation, submission, and approval — keyed by the userid header. Pair these with the announcement and custom field endpoints to thread expense submission into broader HR workflows.

What are the rate limits for the BizMerlin API?

The OpenAPI spec does not document explicit rate limits. BizMerlin tenants typically share per-tenant capacity; treat large bulk operations as best-effort and back off on HTTP 429. For high-volume sync, batch reads through /list endpoints rather than re-querying detail per record.

How do I assign a training to employees through Jentic?

Run pip install jentic, then search 'assign a training to employees'. Jentic returns the relevant trainings endpoint with its input schema, you supply the training id and a list of userids, and execute. The x-api-key and userid headers are injected by Jentic at execution time.

Does this API cover payroll and benefits?

The endpoints in this spec focus on time, expenses, leaves, recruiting, performance, training, and announcements. Payroll and benefits are typically administered through BizMerlin's broader product surface and may not be present in this OpenAPI cut. Check the BizMerlin developer documentation for those modules.