# REST API reference v04 [Beta]

**Warning:**
Salaxy API v04 is in beta: it may change, and it is not used in production yet. Build on v03, the current version.

Version: [v03 (current)](https://code.salaxy.com/reference/rest-api.md) · **v04 (beta)**

The API is **Finland only**; other countries launch on [MCP](https://code.salaxy.com/reference/mcp.md). Hosts for test, demo and production: [Environments](https://code.salaxy.com/get-started/environments.md).

**Agents and code generators:** read the OpenAPI document directly — [`/openapi/salaxy-04.json`](https://code.salaxy.com/openapi/salaxy-04.json) — rather than this rendered page.

  The interactive reference is rendered from the OpenAPI document: https://code.salaxy.com/openapi/salaxy-04.json

**The API rules every call follows** (also in the reference's Introduction):

- **REST authentication** — How to get an access token for the Salaxy REST API (Finland) — which flow fits which integration, and how tokens work. [Full page](https://code.salaxy.com/security/rest-authentication.md)
- **Errors** — How the Salaxy REST API reports failures — one JSON error shape, a few HTTP statuses, no stable error codes. Branch on the status, not the message. [Full page](https://code.salaxy.com/reference/errors.md)
- **Queries and paging** — OData-style queries on Salaxy REST list endpoints — $filter, $search, $orderby, and paging with nextPageLink. Avoid $top. [Full page](https://code.salaxy.com/reference/queries.md)
- **Retries and idempotency** — How to make retried requests safe with the Salaxy REST API — no general idempotency key; use your own ids and look before you create. [Full page](https://code.salaxy.com/reference/idempotency.md)
- **Events and polling** — The Salaxy REST API has no webhooks or push notifications today — poll the read endpoints. What to poll, and how often. [Full page](https://code.salaxy.com/reference/polling.md)
- **Versions and changes** — Which Salaxy REST API version to build on, how v04 differs from v03, how to move one area at a time, and what changed in the v03 reference recently. [Full page](https://code.salaxy.com/reference/versions.md)
