Everything you can request, plan-filtered, in one call: formats, widths, quality, ratios, resolutions, the color option and the modifier flags (shadow/transparency/ground/mirroring/watermark) with whether your plan allows each.
API v2 add-on: with the add-on the response adds an addon section: the add-on formats, every add-on option your key may use with its values (lights, background, color, windows, plate, fit, size, hotspots) and the groups.
Request
curl "https://api.vehicleimagery.com/api/options" \
-H "x-api-key: YOUR_API_KEY"200 · Bundled options.
{
"formats": [
"png",
"webp",
"jpeg",
"avif"
],
"widths": [
200,
400,
800,
1200,
1600,
2000
],
"quality": {
"min": 40,
"max": 100,
"default": 82
},
"modifiers": {
"shadow": {
"param": "shadow",
"values": [
"true",
"false"
],
"allowed": true
},
"mirroring": {
"param": "mirroring",
"values": [
"true",
"clean"
],
"allowed": true,
"note": "floor reflection; needs a transparent variant; shadow=false drops the underbody"
}
},
"params": [
"format",
"resolution",
"ratio",
"width",
"height",
"quality",
"color",
"shadow",
"transparency",
"ground",
"mirroring"
],
"addon": {
"formats": [
"png",
"webp",
"jpeg",
"avif"
],
"options": {
"lights": {
"param": "lights",
"values": [
"on",
"off"
]
},
"windows": {
"param": "windows",
"values": [
"see_through",
"dark"
]
},
"size": {
"param": "size",
"values": {
"2k": 2560,
"1080p": 1920,
"720p": 1280,
"540p": 960,
"360p": 640,
"thumb": 320
}
}
},
"groups": [
"hero",
"steered",
"extra",
"drone",
"360",
"lifestyle"
]
}
}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."
} 
