Reference

All color names

GET/api/colors

Every active catalog color as color_name + color_make pair, plan-filtered. Vehicleimagery colors (house colors) appear in every car's /colors; make colors only for cars of that make. Per-car visibility is in the config /colors endpoint.

Request

curl "https://api.vehicleimagery.com/api/colors" \
  -H "x-api-key: YOUR_API_KEY"

200 · Colors.

{
  "colors": [
    {
      "color_name": "default",
      "color_make": "Vehicleimagery"
    },
    {
      "color_name": "Bell Flower",
      "color_make": "Hyundai"
    },
    {
      "color_name": "wine_red",
      "color_make": "Vehicleimagery"
    }
  ]
}

401 · Missing or invalid `x-api-key`.

{
  "error": "Invalid API key"
}

403 · Plan restriction (feature, format or brand not allowed) or blocked request.

{
  "error": "Mirroring is not allowed by your plan."
}

404 · No data for the requested path.

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}