Acrual API
Browse all Acrual APIs★ Only Publicly Available OpenAPI DocumentFinanceAccountingbearer46 EndpointsREST
For Agents
Manage construction and manufacturing back-office records — clients, jobs, quotes, invoices, purchase orders, time entries, and webhooks — through Acrual's REST API.
Use for: I need to create a new construction job for a client, Issue an invoice for a completed job in Acrual, List all open purchase orders linked to a supplier, Find all time entries logged against a specific job this week
Not supported: Does not handle general ledger accounting, payroll, or bank reconciliation — use for construction and manufacturing job, invoice, and time tracking only.
Jentic publishes the only available OpenAPI specification for Acrual API, keeping it validated and agent-ready. Acrual is a business management platform for manufacturing and construction businesses that exposes endpoints for clients, employees, jobs, quotes, invoices, purchase orders, time entries, suppliers, and variations. The API supports webhook subscriptions and third-party integration handshakes, so back-office tools can react to changes in jobs and invoices in near real time. Authentication uses bearer tokens, and the spec covers 46 operations across 11 resource groups under the /v1.0 path prefix.
Install Jentic One Beta
Connect the Acrual API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Acrual API, 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.
1
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 | sh2
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 instanceJentic 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 Acrual API.
Create and update construction or manufacturing jobs and attach files via /v1.0/jobs and /v1.0/jobs/{id}/files
Issue invoices and purchase orders linked to jobs and clients through /v1.0/invoices and /v1.0/purchase-orders
Capture and reconcile employee time entries against specific jobs via /v1.0/time-entries
Generate, send, and convert quotes into jobs through the /v1.0/quotes resource
Subscribe to job, invoice, and quote events with webhook registrations on /v1.0/hooks
Track variations and supplier records to keep project costs aligned with the original quote
Use Cases
Patterns agents use Acrual API for, with concrete tasks.
★ Construction job invoicing automation
Trades and construction businesses use Acrual to track jobs from quote to completion, then invoice the client. An agent can read job status from /v1.0/jobs/{id}, generate an invoice through /v1.0/invoices when the job is marked complete, and attach the invoice to the job folder. This removes the manual step of bookkeepers re-keying job data into separate accounting software.
Fetch the job at /v1.0/jobs/123, confirm status is 'completed', then POST a new invoice to /v1.0/invoices referencing that job and its client
Time entry reconciliation
Operations managers reconcile timesheets weekly, matching employee time entries to specific jobs and validating against quoted hours. An agent can pull time entries via /v1.0/time-entries, group by job, compare totals to the quote on /v1.0/quotes/{id}, and flag overruns. This shortens a half-day reconciliation pass to a few API calls.
List time entries from the last 7 days for job 456, sum total hours, and compare to the quoted hours on the linked quote
Webhook-driven accounting sync
Businesses that mirror Acrual records into a separate accounting tool register webhooks on /v1.0/hooks for invoice and purchase order events. An agent can subscribe to invoice.created and purchase_order.updated, then push each payload into Xero or QuickBooks. The integration handshake endpoints under /v1.0/integrations also let agents complete OAuth-style links to external systems.
Register a webhook on /v1.0/hooks for the 'invoice.paid' event and route incoming payloads to a downstream accounting endpoint
AI agent build assistant
Developers building agent assistants for trade businesses use Jentic to expose Acrual operations alongside accounting and scheduling APIs. Through Jentic's intent search, an agent can find 'create a job' or 'issue an invoice' without browsing Acrual docs, and the bearer token is stored in Jentic's vault rather than handled by the agent. Integration moves from days of manual wiring to under an hour.
Search Jentic for 'create an invoice in Acrual', load the operation schema, and execute it with values for client_id, job_id, and line items
Key Endpoints
46 endpoints — jentic publishes the only available openapi specification for acrual api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/v1.0/jobs
List jobs
POST
/v1.0/jobs
Create a job
POST
/v1.0/invoices
Issue an invoice
GET
/v1.0/quotes
List quotes
POST
/v1.0/hooks
Register a webhook subscription
GET
/v1.0/time-entries
List time entries
GET
/v1.0/clients
List clients
GET
/v1.0/purchase-orders
List purchase orders
GET
/v1.0/jobs
List jobs
POST
/v1.0/jobs
Create a job
POST
/v1.0/invoices
Issue an invoice
GET
/v1.0/quotes
List quotes
POST
/v1.0/hooks
Register a webhook subscription
GET
/v1.0/time-entries
List time entries
GET
/v1.0/clients
List clients
GET
/v1.0/purchase-orders
List purchase orders
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Acrual bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped execution handles, so the raw bearer token never appears in prompt context, logs, or tool arguments.
Intent-based discovery
Agents search Jentic by intent, e.g. 'create an Acrual invoice' or 'register a job webhook', and Jentic returns the matching Acrual operation with its input schema — no doc-browsing required.
Time to first call
Direct Acrual integration: 1-3 days for auth, webhook plumbing, and error handling. Through Jentic: under 1 hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Acrual API through Jentic.
Why is there no official OpenAPI spec for Acrual API?
Acrual does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Acrual API 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 Acrual API use?
Acrual uses HTTP bearer token authentication. You pass an Authorization: Bearer <token> header on every request. Through Jentic, the bearer token is stored encrypted in the Jentic vault and never enters the agent's context — the agent receives a scoped execution handle instead of the raw secret.
Can I create invoices and purchase orders with the Acrual API?
Yes. POST to /v1.0/invoices to issue an invoice and POST to /v1.0/purchase-orders to raise a PO. Both can be linked back to a job and a client record. The spec covers 46 operations in total across jobs, invoices, quotes, purchase orders, time entries, suppliers, and webhooks.
What are the rate limits for the Acrual API?
The OpenAPI spec does not declare explicit rate limits, so check Acrual's developer portal for the current ceiling. Build retries with exponential backoff around 429 responses, and prefer webhook subscriptions on /v1.0/hooks for change notifications instead of polling.
How do I subscribe to invoice events with the Acrual API through Jentic?
Run pip install jentic, search Jentic for 'register an Acrual webhook', load the schema for POST /v1.0/hooks, and execute it with the target URL and event type. Jentic handles the bearer auth via its vault, so the only inputs your agent needs are the callback URL and the event filter.
Does the Acrual API support file attachments on jobs?
Yes. The /v1.0/jobs/{id}/files and /v1.0/jobs/{id}/files/folder endpoints let you upload and organise files inside a job folder, which is how construction crews keep site photos, drawings, and signed variations attached to the job record.
GET STARTED