🚌 A Big Day for BusOva - New API, Developer Hub & More

The past 48 hours have seen some of the most significant additions to BusOva in recent memory. From an updated public API and a fully-featured developer hub, to homepage improvements and a requested new bus status - there's a lot to cover, so let's dive in.

🛠️ Yesterday - "Awaiting Entry to Service" Status

Following a suggestion from our community, BusOva now officially recognises a seventh vehicle status: Awaiting Entry to Service.

This status is designed for brand-new vehicles that have been delivered to an operator but haven't yet carried passengers in revenue service. Previously, these vehicles had no appropriate status to describe their situation - they weren't Active, they weren't Preserved, and calling them Withdrawn would have been just wrong. Now they have a home.

The new status has been rolled out across the entire platform - add forms, edit forms, admin panels, status filters, the API, badge displays, and the Knowledge Hub have all been updated to reflect the change. You'll spot it with its distinctive teal colour and clock icon wherever statuses appear on the site.

🚀 Today - BusOva API v2.0

This is the big one. BusOva now has a fully public, versioned API - and it's available to anyone who applies for access.

The BusOva API gives developers, enthusiasts, and hobbyists programmatic access to the same live data that powers the website. Want to build a registration lookup tool? A Discord bot for your bus spotting group? A mobile app? A stats dashboard? It's all now possible.

Here's what's available right out of the gate:

  • Buses - list, search, look up by registration, filter by operator or status
  • Operators - full operator data with search and pagination
  • Manufacturers - browse and search the entire manufacturer database
  • Models - full model catalogue with filtering
  • Routes - route listings, individual route details, stops per route, and routes by operator
  • Search - global cross-entity search across operators, manufacturers, and models
  • Stats - platform-wide statistics and your personal API quota usage

Every endpoint returns a consistent JSON envelope with status, data, pagination, and HTTP codes. Authentication is handled via an X-API-Key header. Rate limits apply per plan, and all requests are logged against your key.

API access is free to apply for. Head to the new Developer Hub to apply.

📚 Brand New Documentation Hub

A good API deserves great documentation - so we built it from scratch. The new Documentation Hub at /documentation/ replaces the old single-page API docs entirely and is split into four focused sections:

  • Quickstart Guide - get your first successful API response in under five minutes, step by step
  • API Reference - complete reference for every endpoint with expandable cards, parameter tables, and live "Try It" buttons
  • Code Examples - working, copy-pasteable examples in JavaScript, PHP, and Python covering common use cases
  • API Test Suite - a live test runner that fires every single endpoint and shows you the results in real time

All documentation pages are fully integrated into the site - they respect your dark or light theme preference and automatically inject your API key into interactive examples if you're logged in and approved.

👨‍💻 Rebuilt Developer Hub

The Developer Hub at /developer/ has been completely rebuilt. It now serves as a proper landing page for anyone wanting to build with BusOva data, featuring live platform statistics, navigation to all documentation pages, a clear plans breakdown, and an application form for requesting API access.

Approved developers can also see their API key, current plan, rate limit, and today's usage directly on the hub - no digging around needed.

📸 Homepage - Featured Bus Photo

A small but lovely change to the homepage: the static volunteer image has been replaced with a randomly selected bus photo from our community's contributions. Every time the homepage loads, you'll see a different bus - complete with the make and model underneath, and a clickable link to the photographer's profile.

It's a small way of showcasing the brilliant photography our members contribute, and a nice reminder of what makes BusOva what it is.

What's Next?

With the API now live, the door is open for the community to start building on top of BusOva. If you build something - a tool, a bot, an app, anything - we'd love to hear about it. Drop us a message through the contact page or mention it in the community.

As always, thank you for being part of BusOva. Here's to the next update. 🚌