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.