curl --request POST \
  --url https://api.example.com/v1/optimize \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "route": {
    "total_distance_miles": 123,
    "total_duration_minutes": 123,
    "start": {
      "lat": 0,
      "lng": 0
    },
    "end": {
      "lat": 0,
      "lng": 0
    },
    "polyline": "<string>",
    "waypoints": [
      {
        "lat": 0,
        "lng": 0
      }
    ]
  },
  "stations": [
    {
      "id": "<string>",
      "name": "<string>",
      "address": "<string>",
      "location": {
        "lat": 0,
        "lng": 0
      },
      "brand": "<string>",
      "price_per_gallon": 50,
      "fuel_type": "regular",
      "miles_from_route_start": 1,
      "detour_minutes": 1,
      "metadata": {}
    }
  ],
  "vehicle": {
    "mpg": 100,
    "tank_capacity_gallons": 250,
    "current_fuel_gallons": 250,
    "year": 2005,
    "make": "<string>",
    "model": "<string>"
  },
  "params": {
    "time_value_dollars_per_minute": 0.5,
    "destination_reserve_fraction": 0.1,
    "inter_stop_buffer_fraction": 0.05
  }
}
'

{
  "stops": [
    {
      "station_id": "partner_xyz_001",
      "station_name": "Pilot",
      "station_address": "456 Truck Rd, Flagstaff, AZ",
      "miles_from_route_start": 487.3,
      "gallons_to_purchase": 247.2,
      "price_per_gallon": 4.29,
      "total_cost_at_stop": 1060.49,
      "detour_minutes": 3.2
    }
  ],
  "summary": {
    "total_fuel_cost": 1847.32,
    "total_fuel_gallons": 432.1,
    "total_time_hours": 31.5,
    "total_distance_miles": 2015.3,
    "fuel_remaining_at_destination_gallons": 32.4,
    "baseline_comparison": {
      "strategy_description": "Refuel to full at the next station ahead whenever the tank reaches 25% capacity.",
      "naive_total_fuel_cost": 2089.74,
      "naive_total_time_hours": 31.8,
      "savings_dollars": 242.42,
      "savings_percent": 11.6
    }
  },
  "feasible": true,
  "warnings": [],
  "request_id": "req_jkl345mno678"
}