Dealers

GET /dealers

List approved dealerships available for quote requests.

Query Parameters

Param	Type	Default	Description
limit	integer	20	Results per page (max 100)
offset	integer	0	Pagination offset

Example Request

curl -H "Authorization: Bearer qfx_your_api_key" \
  "https://app.quotefox.au/api/v1/dealers?limit=10"

Response

{
  "dealers": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "ABC Motors Melbourne",
      "suburb": "Richmond",
      "state": "VIC"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "Sydney Auto Group",
      "suburb": "Parramatta",
      "state": "NSW"
    }
  ],
  "total": 2,
  "limit": 10,
  "offset": 0
}

---

GET /dealers/:id/inventory

List a specific dealer's vehicle inventory with pricing.

Path Parameters

Param	Type	Description
id	UUID	Dealership ID

Query Parameters

Param	Type	Default	Description
limit	integer	20	Results per page (max 100)
offset	integer	0	Pagination offset

Example Request

curl -H "Authorization: Bearer qfx_your_api_key" \
  "https://app.quotefox.au/api/v1/dealers/550e8400-e29b-41d4-a716-446655440000/inventory"

Response

{
  "dealership": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "ABC Motors Melbourne"
  },
  "inventory": [
    {
      "globalCarId": "car-uuid-1",
      "model": "MG ZS",
      "version": "Excite 1.5L Auto",
      "baseListPriceAud": 28990,
      "imageUrl": "https://...",
      "bodyType": "SUV"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

TIP

Use the globalCarId from inventory results when creating quote requests — it's more precise than model+version matching.

Code Examples

Python

import requests

headers = {"Authorization": "Bearer qfx_your_api_key"}

# List dealers
dealers = requests.get(
    "https://app.quotefox.au/api/v1/dealers",
    headers=headers
).json()

# Get inventory for the first dealer
dealer_id = dealers["dealers"][0]["id"]
inventory = requests.get(
    f"https://app.quotefox.au/api/v1/dealers/{dealer_id}/inventory",
    headers=headers
).json()

for vehicle in inventory["inventory"]:
    print(f"{vehicle['model']} {vehicle['version']} — ${vehicle['baseListPriceAud']:,}")

Node.js

const headers = { Authorization: "Bearer qfx_your_api_key" };
const BASE = "https://app.quotefox.au/api/v1";

// List dealers
const dealers = await fetch(`${BASE}/dealers`, { headers }).then(r => r.json());

// Get inventory for the first dealer
const dealerId = dealers.dealers[0].id;
const inventory = await fetch(`${BASE}/dealers/${dealerId}/inventory`, { headers })
  .then(r => r.json());

inventory.inventory.forEach(v =>
  console.log(`${v.model} ${v.version} — $${v.baseListPriceAud.toLocaleString()}`)
);