# nisebookings

> Booking system for the modern web: a complete booking engine — appointments, classes with a waiting
> list, recurring series, prepaid bundles, event tickets, day rentals, deposits and VAT — that a
> developer or agency embeds in a website they build themselves, with two lines of HTML or the public
> API. The business runs its own admin and receives payments into its own Mollie account. Everything in
> the admin is also reachable from code: a management API with scoped keys, a hosted MCP server, a free
> 24-hour sandbox, signed webhooks and idempotent writes.

The marketing site exists in English (/) and Dutch (/nl/). The documentation is English and lives on
https://guide.nisebookings.com (every page also exists as .md for agents).

## Start here

- [Documentation home](https://guide.nisebookings.com/index.html): widget, APIs, admin, e-mail, data and privacy.
- [When to use it](https://guide.nisebookings.com/09-when-to-use.html): honest fit check, incl. what it cannot do.
- [Quickstart](https://guide.nisebookings.com/01-quickstart.html): bookings on a website, WordPress or a custom front-end in minutes.
- [Concepts](https://guide.nisebookings.com/02-concepts.html): services, appointments, bookings, orders, statuses, money, time zones.

## For agents and developers

- [Sandbox](https://guide.nisebookings.com/08-sandbox.html): `POST https://app.nisebookings.com/api/sandbox` (no sign-up)
  returns a 24-hour test account with a public key and an all-scopes API key; mail is captured, Mollie is faked.
- [MCP server](https://guide.nisebookings.com/api/mcp.html): `https://app.nisebookings.com/api/mcp` (Streamable HTTP,
  `Authorization: Bearer nk_…`); connect snippets for Claude Code, Codex, Cursor and VS Code.
- [Management API](https://guide.nisebookings.com/api/index.html): `/api/v1` with scoped keys; everything the admin can do
  (settings, services, staff, schedules, customers, appointments, bookings, packages, events, payments, coupons,
  notifications, webhooks) is also available here. JSON in camelCase, timestamps RFC 3339 UTC.
- [Public API](https://guide.nisebookings.com/04-public-api.html): slots, bookings, tickets and payments for a custom front-end.
- [Widget reference](https://guide.nisebookings.com/03-widget-reference.html): `<nise-booking>` and `<nise-events>`.
- [Webhooks](https://guide.nisebookings.com/10-webhooks.html): signed (Standard Webhooks, HMAC-SHA256) events for bookings,
  tickets and payments, with retries and a delivery log.
- Idempotency: send an `Idempotency-Key` header on every `POST` and retry with the same key; a replay returns the stored response.
- [Agent instruction files](https://guide.nisebookings.com/agents/index.html): AGENTS.md, a Claude Code skill, Copilot instructions.
- [Examples](https://guide.nisebookings.com/examples/index.html): widget embed and a headless booking script.
- Machine-readable: [OpenAPI (management)](https://guide.nisebookings.com/api/openapi.yaml),
  [OpenAPI (public)](https://guide.nisebookings.com/openapi.yaml),
  [docs index](https://guide.nisebookings.com/llms.txt), [full docs as one file](https://guide.nisebookings.com/llms-full.txt).
- Served spec (JSON): [public API](https://app.nisebookings.com/openapi.json),
  [management API](https://app.nisebookings.com/api/v1/openapi.json).

## Plans (introductory prices, per month, per site)

- **Free** € 0: 50 bookings/month, 250 customers, 1 staff member, 1 site; booking form, public API, docs, sandbox.
- **Pro** € 19 (€ 190/year): 1,000 bookings/month, unlimited customers and staff, every feature
  (classes, waiting list, bundles, tickets, rentals, coupons, intake questions, webhooks), online
  payments through the business's own Mollie account, management API keys and the MCP server.
- **Agency** € 49 (€ 490/year): five client accounts included, then € 9 per account per month;
  1,000 bookings per account; switch between client accounts with one login.
- No per-seat pricing in any plan. VAT is not stated in these prices yet.

## Key facts

Hosted service for websites built with Astro, Next.js, plain HTML or WordPress (this site is Astro and
the booking form is the same web component); the admin is in Dutch, customer mails and the booking form
in Dutch and English; EUR; VAT-inclusive or exclusive pricing per service; online payments through the
business's own Mollie account (iDEAL, card) or pay on site; every business's data is isolated; built by
nise in The Hague, the Netherlands.