# Agreli

> Agreli is a Dutch SaaS for onboarding new employees in hospitality and retail. The new hire fills in their details on their own phone, two different people check them (four-eyes), the contract is signed digitally and the employee is created in payroll. The Hosted Onboarding API lets other software start an onboarding, send the employee to a hosted page and follow progress through signed webhooks.

The product, its UI and the API error messages are in Dutch. This file and llms-full.txt are in English; the docs pages and the descriptions in the OpenAPI spec are in Dutch. Field names, paths, codes and JSON are the same in every language.

- API base URL: https://app.agreli.nl/api/public (all paths start with /v1)
- Authentication: `Authorization: Bearer hrs_live_…` (production) or `hrs_test_…` (sandbox)
- Format: JSON, snake_case fields, prefixed ids (`onb_…`, `org_…`, `loc_…`), amounts in cents, ISO 8601 dates
- The OpenAPI spec is the source of truth; the endpoint reference in these docs is generated from it

## API

- [Full API documentation](https://agreli.nl/llms-full.txt): everything in one Markdown file (English): concepts, authentication, every endpoint with examples, webhooks, sandbox, errors and rate limits
- [OpenAPI 3.1 spec](https://app.agreli.nl/api/public/v1/openapi.json): machine-readable description of every endpoint, request body and response; load it in Postman, n8n or an SDK generator

## Docs pages (Markdown, Dutch)

- [Overview](https://agreli.nl/docs.md): how the Hosted Onboarding API works, base URL and conventions, and how to use these docs with an AI assistant
- [API quickstart](https://agreli.nl/docs/snelstart.md): Create → Redirect → Verify → Webhook in six steps, with curl and a TypeScript fetch example
- [Authentication and API keys](https://agreli.nl/docs/authenticatie.md): Bearer keys hrs_live_/hrs_test_, scopes, Idempotency-Key, API versions (Agreli-Version), the Agreli-Organization header for API partners, key rotation
- [Webhooks](https://agreli.nl/docs/webhooks.md): all events, payload and headers, verifying Agreli-Signature (HMAC-SHA256), secret rotation, redelivery, the events feed, retries and deduplication
- [Embedding and return_url](https://agreli.nl/docs/inbedden.md): allowed domains, return_url, embedding the hosted onboarding with embed.js and its postMessage events
- [Sandbox and going live](https://agreli.nl/docs/sandbox.md): test keys, POST /v1/sandbox/onboardings/{id}/advance, production access for software partners
- [Errors and rate limits](https://agreli.nl/docs/fouten.md): error format, error types and codes, 120 requests per minute, pagination
- [API reference](https://agreli.nl/docs/api.md): every endpoint with scope, parameters, request and response examples, generated from the OpenAPI spec

## Optional

- [Docs website](https://agreli.nl/docs): the same docs pages as HTML
- [Developers](https://agreli.nl/developers): product page for the Hosted Onboarding API, with pricing (EUR 7 per completed onboarding, sandbox free)
- [Agreli for employers](https://agreli.nl/): what the product does for employers, with pricing
- [Agreli for accountants](https://agreli.nl/accountants): free partner portal for accounting firms and payroll administrators
- [Privacy](https://agreli.nl/privacy): how employee data is protected (draft)