Hire A Bus
Sign in
Changelog

What changed, and when

Additive changes — a new field, a new endpoint, a new event — arrive without notice and without a version bump, so write your client to ignore fields it does not recognise. Anything that could break a working integration gets a new version in the URL and a note here.
Hire A Bus operator APIVersion 1.0.042 endpointshttps://hireabus.com

1.0.0 — Operator API v1

2026-08-05

  • Jobs, bookings, drivers and payouts are readable with a scoped key.
  • Quotes can be submitted, revised, withdrawn and declined, and booking requests answered.
  • Webhooks for `job.offered` and `booking.confirmed`, signed the same way the business platform has always signed.
  • Writes take an `Idempotency-Key`: replaying one returns the original response instead of repeating the work.
  • The reference on this site is generated from the code and byte-compared against it by the test suite.

How we version

The version lives in the path (/api/v1). While v1 is current we will add to it, never remove from it or change what an existing field means. If we ever have to break something, v1 keeps working alongside the replacement for long enough for you to move — you will not find out from a 500.

The reference on this site is regenerated from the code and compared against it byte for byte by our own test suite, and real responses are validated against it on every run. So "the docs are out of date" is not a failure mode we can ship: it fails our build first.