Reference

One color by id

GET/api/colors/{color_id}

A single color by its color_id from /api/colors. 0 is default, the original paint. Unknown or inactive id → 404; a color your plan does not allow → 403.

Path parameters

Name	Type	Description
`color_id` required	integer	The color's unique id.

Request

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

200 · The color.

{
  "color_id": 1544,
  "color_name": "Fern Green Metallic",
  "color_make": "BMW"
}

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."
}