# REST API reference [Finland]

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).

**Start on v03.** Salaxy API v03 is the current version. Salaxy API v04 is in beta: it may change, and it is not used in production yet. Build on v03, the current version. [Reference for v04 (beta)](https://code.salaxy.com/reference/rest-api-v04.md).

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

**Agents and code generators:** read the OpenAPI document directly — [`/openapi/salaxy-03.json`](https://code.salaxy.com/openapi/salaxy-03.json) — rather than this rendered page. It is the same content, and about 1 MB of JSON is far cheaper to parse than this UI.

  The interactive reference is rendered from the OpenAPI document: https://code.salaxy.com/openapi/salaxy-03.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)
