Fleet

Search availability across enabled brands, then mint a token to lock in a specific vehicle.

POST /fleet/list — Step 1: availability search

Fans out in parallel to every enabled brand for your tenant and returns one flat cars[]. A brand that errors or times out contributes an entry to meta and errors but does not fail the whole response — /fleet/list never returns 5xx because of a bad upstream.

Field	Type	Notes
pickup_location \| pickup_lat+lng \| pickup_place_uuid	string \| numeric \| uuid	One of three is required. Ditto for dropoff; dropoff mirrors pickup if omitted.
pickup_radius_km	int, 0..500	optional, default 50. Only used for lat/lng resolution.
pickup_date / dropoff_date	YYYY-MM-DD	required.
pickup_time / dropoff_time	HH:MM	required.
passenger_country_code	ISO-3166 alpha-2	required.
passenger_age	int, 18..99	required.
brand \| brands[]	int \| int[]	optional. Omit to fan out to every enabled brand.
include_unbookable	bool	Default true.

Request body

bash

curl -X POST https://greenflow.live/api/v1/fleet/list \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_location": "AACGH",
    "pickup_date": "2026-05-15", "pickup_time": "10:00",
    "dropoff_date": "2026-05-18", "dropoff_time": "10:00",
    "passenger_country_code": "BR",
    "passenger_age": 30,
    "brands": [11]
  }'

Response · 200 OK

json

{
  "cars": [
    {
      "brand_id": 11, "brand_code": "LOCALIZA", "brand_name": "LOCALIZA",
      "vehicle_code": "B", "vehicle_name": "Fiat Mobi 1.0",
      "transmission": "Manual", "seats": 4, "doors": 2, "luggage": 4,
      "price": { "currency": "BRL", "total": 272.38, "daily": null },
      "rates": [
        { "code": "011880", "name": "Padrão", "currency": "BRL",
          "total_amount": 236.85, "estimated_total_amount": 272.38 }
      ],
      "bookable": true, "bookable_reason": null,
      "pickup_office": "AACGH", "dropoff_office": "AACGH"
    }
  ],
  "offices": [{ "id": 27712, "code": "AACGH", "name": "AGENCIA AEROPORTO CONGONHAS", "brand_id": 11 }],
  "places": { "pickup": [], "dropoff": [] },
  "groups": [],
  "days_calc": 3,
  "meta": { "LOCALIZA": { "count": 22, "bookable_count": 22, "ms": 1404, "rate_codes": ["011880"] } },
  "errors": {},
  "cached": false
}

Location resolution

Pass any one of three forms: pickup_location (office code), pickup_lat + pickup_lng, or pickup_place_uuid. Coordinates resolve to the nearest office per brand. Place UUIDs come from GET /places/autocomplete.

POST /fleet/show — Step 2: mint a tokenc

Replays a single-vehicle quote and returns a tokenc that POST /bookings must echo. The token caches the provider envelope for 3 hours so booking does not re-query the GDS for metadata.

bash

curl -X POST https://greenflow.live/api/v1/fleet/show \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": 11, "pickup_location": "AACGH", "dropoff_location": "AACGH",
    "pickup_date": "2026-05-15", "pickup_time": "10:00",
    "dropoff_date": "2026-05-18", "dropoff_time": "10:00",
    "rate": "011880", "vehicle_code": "B",
    "passenger_country_code": "BR", "passenger_age": 30
  }'

json

{
  "car": { "vehicle_code": "B", "price": { "currency": "BRL", "total": 272.38, "estimated_total": 272.38 }, "rates": [] },
  "tokenc": "836c7fb31f624ca2a8b5a519f26825d2",
  "installments": [
    {"installments": 1, "amount": 272.38, "total": 272.38, "interest_rate": 0.0, "currency": "BRL", "stub": true}
  ],
  "frequent_flyer_programs": [{"iata": "AR", "name": "Aerolineas Argentinas Plus"}],
  "airlines": [{"iata": "AR", "name": "Aerolineas Argentinas"}]
}

Rate adjustment blocks

Each rates[i] exposes optional equipments[], coverages[], inclusions[], taxes[], and discounts[] arrays. Brand support varies; treat all as optional and feature-detect per rate.

Errors

HTTP	Body
401	{"message": "Invalid API key"}
422	{"message": "The pickup location field is required."}
422	{"message": "Unknown pickup_place_uuid or place has no coordinates."}