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"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "count": 2
  }
}

---

GET /dealers/:id/inventory

List a specific dealer's vehicle inventory.

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

{
  "dealershipId": "550e8400-e29b-41d4-a716-446655440000",
  "inventory": [
    {
      "globalCarId": "car-uuid-1",
      "model": "MG ZS",
      "version": "Excite 1.5L Auto",
      "specs": { "bodyType": "SUV", "engine": "1.5L Petrol" },
      "imageUrl": "https://..."
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "count": 1
  }
}

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']}")

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}`)
);