> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.fleetwire.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.fleetwire.io/_mcp/server. # List bookings GET https://api.fleetwire.io/api/v2/bookings Returns bookings (not blocks), newest first, paginated. **Filters** - `trip_start` / `trip_end` — trips starting on/after, ending on/before - `updated_since` — ISO 8601; only bookings changed at or after this moment. Use it to poll incrementally. - `providers` — comma-separated sources, e.g. `direct,turo` - `includeAbandoned=true` / `onlyAbandoned=true` — include unfinished checkouts - `limit` — page size, 1–500 (default 100); follow `links.next` to page - `include` — comma-separated: `renter`, `listing`, `listingImages`, `vehicle`, `payment`, `rentalAgreement`, `stripeIdentity` **Trip and payment fields** - `pickup_location` / `return_location` — where the trip starts and ends: the Turo trip's address, else the delivery address on the order, else the vehicle's branch pickup and return spots - `odometer_start` / `odometer_end` — readings at pickup and return, typed by the host or captured from a connected car; in the company's distance unit - `total` — the booked total, in cents - `amount_paid_in_cents` — what the renter has paid on the order, refundable security deposits excluded; `null` when the booking has no order (Turo trips are paid out by Turo) - `balance_due_in_cents` — still owed on the order Amounts are visible only to tokens whose user can view order financials. **Lookups** (return a single match instead of a list) - `b_id` — one booking by ID - `email` or `phone` — a customer's bookings Reference: https://docs.fleetwire.io/api-reference/bookings/get-bookings ## Authentication - `Authorization` header (bearer token, required) — An API token from **Settings → API tokens** in Fleetwire, sent as `Authorization: Bearer …`. Each token carries scopes: `read` for every GET, plus write scopes such as `bookings:write`. ## Servers - `https://api.fleetwire.io/api` (Production, default) - `https://staging.fleetwire.io/api` (Sandbox (Partner API)) ## Request ### Query parameters - `updated_since` (datetime, optional) — Only bookings changed since this moment - `limit` (integer, optional) — Page size, max 500 - `include` (string, optional) — Related data to include - `trip_start` (string, optional) — Trips starting on/after - `trip_end` (string, optional) — Trips ending on/before - `providers` (string, optional) — Filter by source - `b_id` (string, optional) — Look up one booking - `email` (string, optional) — Look up a customer's bookings ## Response ### 200 OK - `data` (list of V2BookingsGetResponsesContentApplicationJsonSchemaDataItems, optional) - `links` (V2BookingsGetResponsesContentApplicationJsonSchemaLinks, optional) - `meta` (V2BookingsGetResponsesContentApplicationJsonSchemaMeta, optional) ## Errors ### 401 Unauthorized Error Missing or invalid token. - `message` (string, required) ### 422 Unprocessable Entity Error The request is invalid. - `message` (string, required) - `errors` (map from string to list of string, required) — Each invalid field with its problems. ### 429 Too Many Requests Error Too many requests. Wait for the `Retry-After` header (seconds). - `message` (string, required) ## Types ### V2BookingsGetResponsesContentApplicationJsonSchemaDataItems - `b_id` (string, optional) - `l_id` (string, optional) - `r_id` (string, optional) - `complete` (integer, optional) - `status` (string, optional) - `source` (string, optional) - `price_per_day` (integer, optional) - `days` (integer, optional) - `extras_price` (integer, optional) - `delivery_price` (integer, optional) - `discount` (integer, optional) - `taxes` (integer, optional) - `total` (integer, optional) - `amount_paid_in_cents` (integer, optional) - `balance_due_in_cents` (integer, optional) - `trip_start` (string, optional) - `trip_end` (string, optional) - `timezone` (string, optional) - `pickup_location` (string, optional) - `return_location` (string, optional) - `odometer_start` (integer, optional) - `odometer_end` (integer, optional) - `miles_included` (integer, optional) - `created_at` (string, optional) - `updated_at` (string, optional) ### V2BookingsGetResponsesContentApplicationJsonSchemaLinks - `first` (string, optional) - `last` (string, optional) - `prev` (string, optional, nullable) - `next` (string, optional) ### V2BookingsGetResponsesContentApplicationJsonSchemaMeta - `current_page` (integer, optional) - `from` (integer, optional) - `last_page` (integer, optional) - `path` (string, optional) - `per_page` (integer, optional) - `to` (integer, optional) - `total` (integer, optional) ## Examples **Response** ```json { "data": [ { "b_id": "b_EXAMPLE1", "l_id": "l_EXAMPLE1", "r_id": "r_EXAMPLE1", "complete": 1, "status": "reserved", "source": "direct", "price_per_day": 6900, "days": 3, "extras_price": 1500, "delivery_price": 0, "discount": 0, "taxes": 2220, "total": 24420, "amount_paid_in_cents": 24420, "balance_due_in_cents": 0, "trip_start": "2026-11-06 10:00:00", "trip_end": "2026-11-09 10:00:00", "timezone": "America/Chicago", "pickup_location": "Terminal B curbside", "return_location": "Airport lot", "odometer_start": 18250, "odometer_end": 18712, "miles_included": 600, "created_at": "2026-10-20T15:04:11.000000Z", "updated_at": "2026-10-20T15:06:42.000000Z" } ], "links": { "first": "https://api.fleetwire.io/api/v2/bookings?page=1", "last": "https://api.fleetwire.io/api/v2/bookings?page=3", "prev": null, "next": "https://api.fleetwire.io/api/v2/bookings?page=2" }, "meta": { "current_page": 1, "from": 1, "last_page": 3, "path": "https://api.fleetwire.io/api/v2/bookings", "per_page": 100, "to": 100, "total": 248 } } ``` **SDK Code** ```python Bookings import requests url = "https://api.fleetwire.io/api/v2/bookings" querystring = {"b_id":"b_EXAMPLE1","email":"customer@example.com","include":"renter,listing","limit":"100","providers":"direct,turo","trip_end":"2026-11-30 23:59:59","trip_start":"2026-11-01 00:00:00","updated_since":"2026-11-01T00:00:00Z"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript Bookings const url = 'https://api.fleetwire.io/api/v2/bookings?b_id=b_EXAMPLE1&email=customer%40example.com&include=renter%2Clisting&limit=100&providers=direct%2Cturo&trip_end=2026-11-30+23%3A59%3A59&trip_start=2026-11-01+00%3A00%3A00&updated_since=2026-11-01T00%3A00%3A00Z'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Bookings package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.fleetwire.io/api/v2/bookings?b_id=b_EXAMPLE1&email=customer%40example.com&include=renter%2Clisting&limit=100&providers=direct%2Cturo&trip_end=2026-11-30+23%3A59%3A59&trip_start=2026-11-01+00%3A00%3A00&updated_since=2026-11-01T00%3A00%3A00Z" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Bookings require 'uri' require 'net/http' url = URI("https://api.fleetwire.io/api/v2/bookings?b_id=b_EXAMPLE1&email=customer%40example.com&include=renter%2Clisting&limit=100&providers=direct%2Cturo&trip_end=2026-11-30+23%3A59%3A59&trip_start=2026-11-01+00%3A00%3A00&updated_since=2026-11-01T00%3A00%3A00Z") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Bookings import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.fleetwire.io/api/v2/bookings?b_id=b_EXAMPLE1&email=customer%40example.com&include=renter%2Clisting&limit=100&providers=direct%2Cturo&trip_end=2026-11-30+23%3A59%3A59&trip_start=2026-11-01+00%3A00%3A00&updated_since=2026-11-01T00%3A00%3A00Z") .header("Authorization", "Bearer ") .asString(); ``` ```php Bookings request('GET', 'https://api.fleetwire.io/api/v2/bookings?b_id=b_EXAMPLE1&email=customer%40example.com&include=renter%2Clisting&limit=100&providers=direct%2Cturo&trip_end=2026-11-30+23%3A59%3A59&trip_start=2026-11-01+00%3A00%3A00&updated_since=2026-11-01T00%3A00%3A00Z', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Bookings using RestSharp; var client = new RestClient("https://api.fleetwire.io/api/v2/bookings?b_id=b_EXAMPLE1&email=customer%40example.com&include=renter%2Clisting&limit=100&providers=direct%2Cturo&trip_end=2026-11-30+23%3A59%3A59&trip_start=2026-11-01+00%3A00%3A00&updated_since=2026-11-01T00%3A00%3A00Z"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Bookings import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.fleetwire.io/api/v2/bookings?b_id=b_EXAMPLE1&email=customer%40example.com&include=renter%2Clisting&limit=100&providers=direct%2Cturo&trip_end=2026-11-30+23%3A59%3A59&trip_start=2026-11-01+00%3A00%3A00&updated_since=2026-11-01T00%3A00%3A00Z")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```