Irvine Auto Hub Public API

The Irvine Auto Hub Public API is a read-only HTTP JSON API exposing our active dealer inventory. Every vehicle comes with rich metadata — pricing, drivetrain, fuel economy, title status, Carfax report link, factory window sticker (Monroney), color hex codes, and walk-around video — so you can build rich UIs without re-scraping.

It is safe to call directly from a browser: Access-Control-Allow-Origin: * is set on every response.

All endpoints are relative to:

https://irvineautohub.com/api/v1

No authentication is required. No API key, no OAuth, no session cookie. If you need an allowlist-based restriction for partner integrations, contact us.

Breaking changes will ship under /api/v2. Additive changes (new fields on existing responses) may appear on v1 at any time — treat unknown fields as safe to ignore.

Every response includes:

Cache-Control: public, s-maxage=300, stale-while-revalidate=600

Vercel's edge holds results for 5 minutes and serves stale-while-revalidate for another 10. Since inventory changes daily, cached responses are almost always fresh enough.

There is no hard rate limit, but please honor Cache-Control and avoid polling the same vehicle more than once per minute. Abusive traffic may be rate-limited at the edge.

Every item in a list response, and the full body of the detail response, has this shape:

{
  "vehicleId": 1308810,
  "vin": "WP1AF2A54FLB99584",
  "stockNo": "B99584",
  "year": 2015,
  "make": "Porsche",
  "model": "Macan",
  "trim": "Turbo",
  "title": "2015 Porsche Macan Turbo",
  "mileage": 89849,

  "bodyType": "Y",
  "bodyTypeLabel": "SUV",
  "isSold": false,
  "isNew": false,

  "pricing": {
    "internetPrice": 24890,
    "finalPrice": 24890,
    "salePrice": null,
    "discountValue": null,
    "isOnSale": false,
    "promoExpiresAt": null
  },

  "powertrain": {
    "drivetrain": "All Wheel Drive",
    "fuel": "Gasoline Fuel",
    "transmission": "Automatic",
    "engine": "3.6L  6 Cylinders",
    "fuelEconomy": { "city": 17, "highway": 23 },
    "estimatedRangeMiles": 376
  },

  "exterior": {
    "colorName": "White",
    "colorHex": "#E9EAE5"
  },
  "interior": {
    "colorName": "Brown",
    "colorHex": "#8B4513"
  },

  "history": {
    "titleStatus": "Clear",
    "damageType": null,
    "carfaxUrl": "https://www.carfax.com/vehiclehistory/...",
    "autoCheckScore": null
  },

  "media": {
    "primaryImageUrl": "https://images.dealersync.com/...",
    "monroneyStickerUrl": "https://monroneylabels.com/cars/.../window_sticker.jpg",
    "monroneyPageUrl": "https://www.monroneylabels.com/cars/...",
    "videoUrl": null,
    "videoCount": 0
  },

  "listing": {
    "firstListedAt": "2026-03-14T00:00:00.000Z",
    "daysOnLot": 38
  },

  "syncedAt": "2026-04-21T14:00:32.112Z"
}

Field notes

• Nullability: any field may be null when Mesa doesn't supply a value. Treat null as "unknown".
• MPG: powertrain.fuelEconomy is null for vehicles Mesa reports as 0/0 — common for EVs, diesels, and classics. For EVs, check estimatedRangeMiles.
• Sale pricing: pricing.salePrice is only populated when it strictly differs from internetPrice. When displaying, prefer salePrice ?? internetPrice.
• Monroney: monroneyStickerUrl is a direct JPG of the factory window sticker; monroneyPageUrl is the public decoder page.
• Internal fields dropped: isActive, manualHidden, and sourceJson are intentionally omitted. The API only ever returns vehicles where isActive && !isSold && !manualHidden.
• listing.firstListedAt is the first time our sync ingested the vehicle, not necessarily the first day Mesa advertised it. Treat daysOnLot as a lower bound.

bodyType is Mesa's single-letter code; bodyTypeLabel is the human-readable string. Unknown codes fall back to the raw letter.

All errors use this shape:

{ "error": "Inventory database is not configured." }

JavaScript (browser or Node)

const res = await fetch(
  'https://irvineautohub.com/api/v1/inventory?sort=price_asc&pageSize=24'
);
const { items, pagination } = await res.json();

for (const v of items) {
  console.log(v.title, v.pricing.internetPrice, v.powertrain.fuelEconomy);
}

Python

import requests

r = requests.get(
    'https://irvineautohub.com/api/v1/inventory',
    params={'make': 'Porsche'}
)
r.raise_for_status()
for v in r.json()['items']:
    print(v['title'], v['pricing']['internetPrice'])

cURL — single vehicle

curl -s https://irvineautohub.com/api/v1/inventory/1308810 | jq .pricing

cURL — verify CORS headers

curl -I -X OPTIONS https://irvineautohub.com/api/v1/inventory \
  -H 'Origin: https://example.com' \
  -H 'Access-Control-Request-Method: GET'

• v1 (2026-04-22) — Additive update. New filters on /inventory: bodyType, fuel, drivetrain, minYear, maxYear, maxMileage, titleStatus, color. Added listing.firstListedAt / listing.daysOnLot on the Vehicle object. New endpoint GET /api/v1/inventory/stats.
• v1 (2026-04-21) — Initial public release. Adds rich Mesa-sourced fields (Carfax links, MPG, estimated range, title status, Monroney sticker, color hex codes, sale pricing, body type decoding) and strips internal flags.