Version 1
The WeerOm API
Read a shop's bookings, customers, services, staff and payments, take bookings through the shop's own rules and mail, and get a webhook the moment a booking or a payment changes. Send the key the shop made in its admin, and every endpoint answers JSON.
Base URLhttps://api.weerom.com/v1
curl https://api.weerom.com/v1/payments?limit=1 \
-H "Authorization: Bearer $WEEROM_KEY"200 OKapplication/json
{
"object": "list",
"data": [
{
"object": "payment",
"id": "0b6f2a4e-5d1c-4f7a-9a3e-2c8d1e6f4b90",
"booking_code": "UEAMEFC9",
"paid_at": "2026-11-21T10:12:40.000Z",
"description": "Knippen en baard",
"amount_cents": 4000,
"net_cents": 3306,
"vat_cents": 694,
"vat_percent": 21,
"currency": "EUR",
"method": "bancontact",
"customer": { "name": "Lotte Peeters", "email": "[email protected]" }
}
],
"has_more": true,
"next_cursor": "WzE3OTUyODcxMzA0MTIsIjBiNmYy..."
}- Requests a minute for each key
- 120
- Objects on one page, at most
- 100
- Money in whole cents, VAT included
- 4000 = €40
- Every time, in ISO 8601
- UTC
Guides
Eight guides, from a first request to a booking page of your own and webhooks.
- QuickstartMake a key, send a first request and read the answer.
- AuthenticationRead, write and public keys, where a shop makes them, what 401 and 403 mean.
- Build a booking pageShow free times and take bookings on your own page, with a public key.
- WebhooksFour events, signed with the shop's secret and retried 6 times over 33 hours when your server does not answer.
- PaginationWalk every page with a cursor, and ask only for what changed since the last run.
- Safe retriesSend an Idempotency-Key, and a retry after a timeout books once.
- ErrorsOne error shape, every code, and what to do about each.
- Rate limits120 requests a minute for each key, a visitor's booking limits, and how to back off.
Use cases
Ten things people build on the API. Each names the key it needs, the steps, a code sketch and what the API cannot do for it.
- 01Send payments to BillitMake one invoice in Billit for every payment staff note in WeerOm.Read key
- 02Bookkeeping with AccountableBuild the admin's Accountable lines from the payments: one per day and payment method.Read key
- 03Your own booking pageYour own design on any site, with WeerOm's agenda, rules and mail behind it.Public keyWrite key
- 04Bookings in your calendarCopy every booking into Google Calendar or Outlook and keep the copy current.Read key
- 05Customers in a mailing toolKeep a Mailchimp or Brevo list in step with the shop's customers.Read key
- 06A revenue sheetRevenue per day, per staff member and per payment method in Google Sheets.Read key
- 07AutomationsA flow in n8n, Make or Zapier, started by a WeerOm webhook or on a schedule.Read keyWrite key
- 08Messages by SMS or WhatsAppSend tomorrow's customers a text or a WhatsApp message through your own provider.Read key
- 09An assistant that booksA chat or phone assistant that finds free times and books them from your server.Write key
- 10Several shops on one screenOne key for each shop and one loop, for an owner with two shops or a group.Read key
Endpoints
Every endpoint works on the shop the key belongs to. Each page has a playground that takes your key.
- GET/shopGet the shop
- GET/servicesList services
- GET/services/{id}Get a service
- GET/staffList staff
- GET/staff/{id}Get a staff member
- GET/availabilityList free times
- GET/customersList customers
- GET/customers/{id}Get a customer
- PATCH/customers/{id}Change a customer
- GET/bookingsList bookings
- POST/bookingsMake a booking
- GET/bookings/{id}Get a booking
- POST/bookings/{id}/cancelCancel a booking
- POST/bookings/{id}/rescheduleMove a booking
- GET/paymentsList payments
- GET/payments/{id}Get a payment