Cargoimg
API

Catalog

Walk makes → models → years → variants → views, or search with q=.

Only published vehicles in your contract categories are visible. Authenticate with x-api-key.

Makes

curl -H "x-api-key: YOUR_KEY" \
  "$APP_URL/v1/makes"
{ "makes": [{ "id": "…", "slug": "daf", "name": "DAF" }] }

Models for a make

curl -H "x-api-key: YOUR_KEY" \
  "$APP_URL/v1/makes/daf/models"

(Equivalent: $APP_URL/v1/makes/daf.)

Years for a model

curl -H "x-api-key: YOUR_KEY" \
  "$APP_URL/v1/makes/daf/models/xf"

Returns { make, model, years } with years newest first.

Vehicle and views for a year

curl -H "x-api-key: YOUR_KEY" \
  "$APP_URL/v1/makes/daf/models/xf/2022"
  • One published variant in your categories: { make, model, vehicle, views }
  • Several variants: { make, model, year, variants } — pick a variant slug, then request views:
curl -H "x-api-key: YOUR_KEY" \
  "$APP_URL/v1/makes/daf/models/xf/2022/{variant}"

views is the list of published camera ids for that vehicle (subset of the nine studio views).

curl -H "x-api-key: YOUR_KEY" \
  "$APP_URL/v1/search?q=daf+xf+2022"

results entries include make, makeSlug, model, modelSlug, year, variant, and category. Filtered to your contract.

Colors and views (reference)

curl -H "x-api-key: YOUR_KEY" "$APP_URL/v1/colors"
curl -H "x-api-key: YOUR_KEY" "$APP_URL/v1/views"

Named colors (hex is accepted on image requests too):

NameHex
red#C41E3A
blue#1E4B8C
green#2E7D32
white#F5F5F5
black#1A1A1A
silver#C0C0C0
yellow#F5C518
orange#E85D04

Studio view ids:

IdLabel
front_leftFront left
frontFront
front_rightFront right
side_rightSide right
rear_rightRear right
rearRear
rear_leftRear left
side_leftSide left
top_downTop down

Continue to Images to request a signed render.

On this page