# AccountCloud API

> AccountCloud is one REST API for the integrations accounting software needs from outside: reading invoices and receipts (OCR) into JSON and UBL, company data from the Dutch and Belgian trade registers, EU VAT number checks at VIES, and address forms for 34 countries. Prepaid, priced per call, with a free test mode.

- Base URL: `https://api.accountcloud.io/v1`. JSON in and out.
- Authentication: `Authorization: Bearer <key>`. Test keys (`ac_test_…`) are free and return fixed test values; live keys (`ac_live_…`) make real, charged calls.
- Errors are RFC 9457 problem+json. Branch on the stable `code`, never on `detail`.
- Every answer to an accepted key has `AccountCloud-Charged` (the cost in euros) and `X-Request-Id`.
- Send an `Idempotency-Key` header with every POST, so a retry never does the work twice.
- The API is in pre-release. Most operations are in preview; `GET /v1/pricing` (no key needed) lists the status and price of each.

## Guides

- [Quickstart](https://docs.accountcloud.io/guides/quickstart/): Get a free test key and make your first two calls to the AccountCloud API, in five minutes.
- [Authentication and keys](https://docs.accountcloud.io/guides/authentication/): API keys, what a key may do, rotating and revoking keys, and the rate limits.
- [Errors](https://docs.accountcloud.io/guides/errors/): The problem+json body of every error, and what each error code means.
- [Idempotency](https://docs.accountcloud.io/guides/idempotency/): Retry a POST safely with an Idempotency-Key. The same key gives the same answer for 24 hours, and is never charged twice.
- [Test mode](https://docs.accountcloud.io/guides/test-mode/): What a test key does, and the fixed test values of every operation.
- [Webhooks](https://docs.accountcloud.io/guides/webhooks/): Receive events from AccountCloud, verify their signature, and what happens when your endpoint fails.
- [Pricing and credit](https://docs.accountcloud.io/guides/pricing/): The base subscription, the price per call, and what each call cost.
- [Addresses](https://docs.accountcloud.io/guides/addresses/): Address forms, validation and formatting for 34 countries.
- [Documents (OCR and UBL)](https://docs.accountcloud.io/guides/documents/): Send invoices and receipts, read what is on them as JSON and UBL, and report a wrong result.
- [Company data and VAT numbers](https://docs.accountcloud.io/guides/companies/): Company profiles from the trade registers of the Netherlands and Belgium, and EU VAT numbers checked at VIES.

## API reference

- [OpenAPI 3.1 spec](https://docs.accountcloud.io/openapi/v1.json): every endpoint, schema and error code of the public API, as JSON
- [API reference](https://docs.accountcloud.io/reference/): the same spec, rendered, with try-it
- [Price list](https://api.accountcloud.io/v1/pricing): the current price and status of every operation, no key needed

## Optional

- [Changelog](https://docs.accountcloud.io/changelog/): What changed in the AccountCloud API, newest first.
- [All guides in one file](https://docs.accountcloud.io/llms-full.txt): the full text of every guide above
- [Status](https://status.accountcloud.io): whether the API and each integration are up
- [Website](https://accountcloud.io/en/): the integrations and the prices