Get started as a developer
The ways to take bookings on your own website, from a link to your own screens, the addresses to use, and your first request to the public booking API.
Tutorial3 min read
Booking Orbit keeps your locations, services, people and free times. As a developer you can let customers book from your own website or app, in the hosted booking screens or in your own design, and let AI assistants work with appointments for your team.
What to use for what
https://app.bifrostorbit.com/booking/b/northwilds-osloThe public booking API needs no key. Reading services and free times works from anywhere; holding a time and booking work from your server and from the websites you allow. See Allowed websites.
Addresses
https://app.bifrostorbit.com/bookinghttps://stage.bifrostorbit.com/bookinghttps://app.bifrostorbit.com/booking/api/public/<location>https://stage.bifrostorbit.com/booking/api/public/<location>https://app.bifrostorbit.com/booking/widget.jshttps://stage.bifrostorbit.com/booking/widget.js<location> is the last part of the location's booking page address, such as northwilds-oslo. Find it under Booking page. Admins change it under Settings › Short name; old addresses then stop working, so change it before you build. Each location is booked on its own, so a website for three shops uses three addresses.
Your first request
Three requests take a booking. You can run them from a terminal, as here, or from your server.
1List the services
curl "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/services"{ "data": { "services": [ { "id": "6ae6548e8e80975012f97d3e", "slug": "boot-fitting", "name": "Boot fitting", "durationMinutes": 45, "mode": "in-person", "price": { "kind": "fixed", "amount": 45000 }, "payment": { "rule": "none", "depositAmount": null }, "staffIds": ["…", "…"] } ] }}Prices are in the currency's smallest unit: 45000 is NOK 450.
2Find a free time
curl "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/slots?service=boot-fitting&days=7&timeZone=Europe/Oslo"The answer lists every day in the time zone you asked for, each with its free times, and next, the first free time even beyond those days.
3Hold it and book
Holding keeps the time for 10 minutes while the customer types their details. Then book with the hold's token:
curl -X POST "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/holds" \ -H "Content-Type: application/json" \ -d '{ "service": "boot-fitting", "startsAt": "2026-11-12T09:45:00.000Z" }'curl -X POST "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/appointments" \ -H "Content-Type: application/json" \ -d '{ "service": "boot-fitting", "startsAt": "2026-11-12T09:45:00.000Z", "holdToken": "…", "name": "Ingrid Berg", "email": "ingrid@northwilds.com", "timeZone": "Europe/Oslo" }'The answer has the appointment's reference, such as 29BMJM, and its manageUrl, where the customer can move or cancel it. Booking Orbit emails the confirmation and the reminders, as it does for the booking page.
A booking is real: try it against a location of your own, and cancel it afterwards with POST/manage/<token>/cancel.
Next steps
- Follow a quickstart for Next.js, React, Vue or plain HTML.
- Look up every endpoint in the public booking API, and every method in the Booking SDK.
- When something fails, every error is JSON with a
codeand a message you can show. Troubleshooting lists them with their fixes.
Was this page helpful?