# Reservations

The Reservations API is the core of the Bob Box integration — reserving a locker compartment for a parcel, looking up reservations, and cancelling one.

- **POST create reservation:** Reserve a compartment at a location for a parcel. The response includes the compartment and all three PINs.
- **GET reservations:** Retrieve your reservations, filterable by location, status, or reference.
- **GET reservation pins:** Re-fetch just the PINs for one reservation. Optional — create and list already return them.
- **POST cancel reservation:** Cancel a reservation that has not been dropped off yet.

**The PINs path looks like a typo. It is not.** Reservations sit at `/bob-box/reservations`, but the PINs endpoint sits at `/bob-box/locations/reservations/pins` — with `locations` in the middle. Copy it exactly.

Instead of polling for status changes, you can have them pushed to your own URL — see the Webhooks section.