Skip to content

Mileages

GET `/api/mileages/v2`

GET Auth required

Returns fuel economy data including city/highway MPG, combined MPG, driving range, and EV efficiency metrics. The demo dataset covers model years 2015–2020. To access the full range from 1900 to today, subscribe and include a valid JWT.

Sample Request

curl "https://carapi.app/api/mileages/v2?year=2024&make=Toyota&model=Prius" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN_HERE"

const params = new URLSearchParams({ year: '2024', make: 'Toyota', model: 'Prius' });

const response = await fetch(`https://carapi.app/api/mileages/v2?${params}`, {
  headers: {
    'Authorization': `Bearer ${jwt}`
  }
});

const data = await response.json();
console.log('Mileages:', data);

import requests

headers = {
    'Authorization': f'Bearer {jwt}'
}

params = {
    'year': '2024',
    'make': 'Toyota',
    'model': 'Prius'
}

response = requests.get(
    'https://carapi.app/api/mileages/v2',
    headers=headers,
    params=params
)

data = response.json()
print('Mileages:', data)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->get('https://carapi.app/api/mileages/v2', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_JWT_TOKEN_HERE',
    ],
    'query' => [
        'year'  => '2024',
        'make'  => 'Toyota',
        'model' => 'Prius',
    ],
]);

$data = json_decode($response->getBody(), true);
print_r($data);

$url = 'https://carapi.app/api/mileages/v2?' . http_build_query([
    'year'  => '2024',
    'make'  => 'Toyota',
    'model' => 'Prius',
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_JWT_TOKEN_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

Sample Response

{
  "collection": {
    "url": "/api/mileages/v2?trim_id=8860",
    "count": 1,
    "pages": 1,
    "total": 1,
    "next": "",
    "prev": "",
    "first": "/api/mileages/v2?trim_id=8860",
    "last": ""
  },
  "data": [
    {
      "id": 8860,
      "make_id": 22,
      "model_id": 4779,
      "submodel_id": 73504,
      "trim_id": 8860,
      "year": 2020,
      "make": "Toyota",
      "model": "Camry",
      "series": null,
      "submodel": "LE",
      "trim": "LE",
      "trim_description": "LE 4dr Sedan (2.5L 4cyl 8A)",
      "fuel_tank_capacity": "15.8",
      "combined_mpg": 32,
      "epa_city_mpg": 28,
      "epa_highway_mpg": 39,
      "range_city": 442,
      "range_highway": 616,
      "battery_capacity_electric": null,
      "epa_time_to_charge_hr_240v_electric": null,
      "epa_kwh_100_mi_electric": null,
      "range_electric": null,
      "epa_highway_mpg_electric": null,
      "epa_city_mpg_electric": null,
      "epa_combined_mpg_electric": null
    }
  ]
}

Filtering

curl "https://carapi.app/api/mileages/v2?year=2024&make=Toyota&json=[{\"field\":\"combined_mpg\",\"op\":\">=\",\"val\":40}]" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN_HERE"

const filter = JSON.stringify([
  { field: 'combined_mpg', op: '>=', val: 40 }
]);

const response = await fetch(
  `https://carapi.app/api/mileages/v2?year=2024&make=Toyota&json=${encodeURIComponent(filter)}`,
  { headers: { 'Authorization': `Bearer ${jwt}` } }
);

const data = await response.json();
console.log('Mileages:', data);

import requests
import json

headers = {
    'Authorization': f'Bearer {jwt}'
}

params = {
    'year': '2024',
    'make': 'Toyota',
    'json': json.dumps([
        {'field': 'combined_mpg', 'op': '>=', 'val': 40}
    ])
}

response = requests.get(
    'https://carapi.app/api/mileages/v2',
    headers=headers,
    params=params
)

data = response.json()
print('Mileages:', data)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->get('https://carapi.app/api/mileages/v2', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_JWT_TOKEN_HERE',
    ],
    'query' => [
        'year' => '2024',
        'make' => 'Toyota',
        'json' => json_encode([
            ['field' => 'combined_mpg', 'op' => '>=', 'val' => 40],
        ]),
    ],
]);

$data = json_decode($response->getBody(), true);
print_r($data);

$filter = json_encode([
    ['field' => 'combined_mpg', 'op' => '>=', 'val' => 40],
]);

$url = 'https://carapi.app/api/mileages/v2?' . http_build_query(['year' => '2024', 'make' => 'Toyota', 'json' => $filter]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_JWT_TOKEN_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);