fleet.json

Version 0.1 · free to use (CC BY 4.0) · 3 October 2026

AI assistants are becoming how people book rides. The big ride apps keep their prices and drivers inside their own apps and take a large cut of every fare. A local taxi or private hire firm has no way to be found by an assistant at all.

fleet.json fixes that. It is one small file a firm puts on its own website, saying where it works, how to book, what cars it has and what it charges. Any assistant or app can read it. Bookings go straight to the firm, by its own phone line or booking page.

How to publish one

  1. Copy the example below and fill in your own details.
  2. Put it on your website at https://yourfirm.com/.well-known/fleet.json (or any https address).
  3. Check it with /v1/fleet_check?url=...
  4. Email the address to fairfare@goodturnstudio.com to be listed in Fair Fare.

Example

{
  "format": "fleet/0.1",
  "name": "Harborne Cars",
  "area": { "country": "GB", "towns": ["Birmingham", "Harborne", "Edgbaston"], "airports": ["BHX"] },
  "contact": { "phone": "+44 121 000 0000", "booking_url": "https://harbornecars.example/book" },
  "licensing": { "authority": "Birmingham City Council", "operator_licence": "PHO 0000" },
  "vehicles": [
    { "type": "saloon", "seats": 4, "child_seat": true },
    { "type": "wav", "seats": 5, "wheelchair": true },
    { "type": "ev", "seats": 4, "ev": true }
  ],
  "tariff": { "currency": "GBP", "flag": 4.00, "per_mile": 2.10, "per_min": 0.25, "minimum": 6.00,
              "fixed": [ { "from": "Birmingham city centre", "to": "BHX", "price": 32 } ] },
  "hours": "24/7",
  "payment": ["cash", "card", "contactless"],
  "updated": "2026-10-03"
}

Fields

format is always fleet/0.1. area names the country (two letters), towns and airports served. contact needs a phone number or an https booking page. licensing.authority is the council or city that licenses the firm. vehicles lists the car types: saloon, sedan, estate, mpv, minibus, wav (wheelchair accessible), executive, black_cab, suv or ev. tariff is optional and gives the starting charge, the rate per mile or km, any per-minute rate and fixed prices. updated is the date the file was last checked. The full schema is at /fleet-schema-0.1.json.

Rules

Only licensed firms. Prices in the file must be the prices you charge. Assistants show listed firms by distance and fit for the trip, never by payment.

Fair Fare · Privacy · Terms · fairfare@goodturnstudio.com