GET /inventory

Search vehicles across all dealers on the QuoteFox platform.

Query Parameters

Param	Type	Required	Description
model	string	Yes	Vehicle model name (partial, case-insensitive match; spaces are normalized so "mazda 3" matches "Mazda3")
limit	integer	No	Results per page (default 20, max 100)
offset	integer	No	Pagination offset (default 0)

Example Request

curl -H "Authorization: Bearer qfx_your_api_key" \
  "https://app.quotefox.au/api/v1/inventory?model=MG+ZS"

Response

{
  "vehicles": [
    {
      "id": "car-uuid-1",
      "model": "MG ZS",
      "version": "Excite 1.5L Auto",
      "specs": { "bodyType": "SUV", "engine": "1.5L Petrol" },
      "imageUrl": "https://..."
    },
    {
      "id": "car-uuid-2",
      "model": "MG ZS",
      "version": "Essence 1.5L Auto",
      "specs": { "bodyType": "SUV", "engine": "1.5L Petrol" },
      "imageUrl": "https://..."
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "count": 2
  }
}

Code Examples

Python

import requests

headers = {"Authorization": "Bearer qfx_your_api_key"}
response = requests.get(
    "https://app.quotefox.au/api/v1/inventory",
    headers=headers,
    params={"model": "MG ZS"}
)

for vehicle in response.json()["vehicles"]:
    print(f"{vehicle['model']} {vehicle['version']}")

Node.js

const headers = { Authorization: "Bearer qfx_your_api_key" };
const response = await fetch(
  "https://app.quotefox.au/api/v1/inventory?model=MG+ZS",
  { headers }
);
const data = await response.json();
data.vehicles.forEach(v =>
  console.log(`${v.model} ${v.version}`)
);

TIP

Use the vehicle id from search results as globalCarId when requesting quotes for precise vehicle matching.