Essentio Public API

The Essentio Public API lets your own software read and change a Business’s data in Essentio over HTTPS: create, issue and send documents, record Payments, change Clients and Products, and read Receipts and reports. Every request acts for exactly one Business — the one its API key or Connected app belongs to — with the Role it carries.

Getting started

An Owner or Admin of the Business creates an API key in Essentio under Settings → API Keys. Send it with every request to https://api.essentio.pro/v1, and read the answers as JSON. The contract is an OpenAPI 3.1 file: the API’s every response is tested against it, and within v1 it only grows — fields, endpoints, error types and the values a field answers (a document’s status, an error’s type) may be added, nothing is renamed or removed. So a program keeps a value it does not know rather than rejecting the answer: the file lists each field’s values today as x-known-values, never as a closed enum.

Guides

Quickstart

Create an API key and make your first request.

Read more

Authentication

API keys and Connected apps: which Business, and which Role.

Read more

OAuth apps

Connect your software to any Business, with PKCE.

Read more

Test business

Try an integration on samples that reach nobody but you.

Read more

Errors and Refusal codes

The one error shape, and the codes a program branches on.

Read more

Pagination

Walk every record of a list by cursor.

Read more

Idempotency

Retry a create or an Action without doing it twice.

Read more

Rate limits

120 requests a minute, and the headers that say how many are left.

Read more

Webhooks

Signed messages when documents and Payments change.

Read more

Versioning

Within v1 the API only grows.

Read more

AI assistants (MCP)

Add Essentio to Claude or ChatGPT, or connect another assistant by its address.

Read more