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

Source: https://docs.bifrostorbit.com/booking/developers/get-started/

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

| You want to | Use | Needs |
| --- | --- | --- |
| Send customers to a ready booking page | A link to the location's booking page, such as `https://app.bifrostorbit.com/booking/b/northwilds-oslo` | Nothing |
| Show the booking screens inside your own page, or in a popup | [The booking widget](https://docs.bifrostorbit.com/booking/developers/embed-the-widget/) | Nothing. It works on any website. |
| Build booking screens in your own design | [The Booking SDK](https://docs.bifrostorbit.com/booking/developers/booking-sdk/) for JavaScript and TypeScript, or the [public booking API](https://docs.bifrostorbit.com/booking/developers/public-api/) from any language | Your website under **Settings › Your website** to book from the browser |
| Show services and free times on a website built with CMS Orbit | The Booking Orbit blocks in CMS Orbit. See [Appointments from Booking Orbit](https://docs.bifrostorbit.com/cms/developers/booking-blocks/). | The space connected under **Linked satellites** |
| Count bookings in Insights Orbit, or ask for reviews afterwards in Presence Orbit | [Events](https://docs.bifrostorbit.com/booking/developers/events/) that Booking Orbit sends through Orbit Exchange | Nothing to build |
| Let an AI assistant find free times and book | The [MCP server](https://docs.bifrostorbit.com/booking/developers/mcp/) | The assistant connected under **AI assistants** |

The 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](https://docs.bifrostorbit.com/booking/developers/allowed-websites/).

## Addresses

| | Production | Staging |
| --- | --- | --- |
| Booking Orbit | `https://app.bifrostorbit.com/booking` | `https://stage.bifrostorbit.com/booking` |
| Public booking API | `https://app.bifrostorbit.com/booking/api/public/<location>` | `https://stage.bifrostorbit.com/booking/api/public/<location>` |
| Widget script | `https://app.bifrostorbit.com/booking/widget.js` | `https://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.

## 1. List the services

```bash
curl "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/services"
```

```json
{
  "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.

## 2. Find a free time

```bash
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.

## 3. Hold it and book

Holding keeps the time for 10 minutes while the customer types their details. Then book with the hold's token:

```bash
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](https://docs.bifrostorbit.com/booking/developers/quickstart-nextjs/), [React](https://docs.bifrostorbit.com/booking/developers/quickstart-react/), [Vue](https://docs.bifrostorbit.com/booking/developers/quickstart-vue/) or [plain HTML](https://docs.bifrostorbit.com/booking/developers/quickstart-html/).
- Look up every endpoint in the [public booking API](https://docs.bifrostorbit.com/booking/developers/public-api/), and every method in the [Booking SDK](https://docs.bifrostorbit.com/booking/developers/booking-sdk/).
- When something fails, every error is JSON with a `code` and a message you can show. [Troubleshooting](https://docs.bifrostorbit.com/booking/developers/troubleshooting/) lists them with their fixes.
