---
title: "Vehicle Images"
method: GET
path: "/images"
tags: ["Images"]
---

# Vehicle Images

`GET /images`

## Request

- Base URL: `https://api.carsxe.com`
- URL: `https://api.carsxe.com/images`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `PAYMENT-SIGNATURE`
  - none
- TypeScript: <https://skmtc.dev/carsxe/apis/carsxe-api/docs/images/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve images of a vehicle by make, model and other filters.

Credit plans: 2 credits per successful billable lookup. Failed lookups and no-data errors do not use credits. See https://carsxe.com/pricing.md for billing units.

## Query parameters

- `make` string, required
- `model` string, required
- `year` string
- `trim` string
- `color` string
- `transparent` boolean
- `angle` 'front' | 'side' | 'back'
- `photoType` 'interior' | 'exterior' | 'engine'
- `size` 'Small' | 'Medium' | 'Large' | 'Wallpaper' | 'All'
- `license` string
- `format` 'json' | 'xml'

## Response `200`

Images retrieved.

- object
  - `success` boolean
  - `error` string
  - `images` object[]
    - `mime` string
    - `link` string
    - `contextLink` string
    - `height` integer
    - `width` integer
    - `byteSize` integer
    - `thumbnailLink` string
    - `accentColor` string
  - `query` object

## Other responses

- `401`: Missing API key, unknown/disabled API key, or inactive account.
- `404`: No images found for this query.
- `429`: API usage limit exceeded for the current billing period.
- `500`: Missing make/model, or the image search failed.

## Changes

- **2026-09-30** `149df30e396a`: 5 breaking
  - removed the enum value `Modify` from the `query` request parameter `license`
  - removed the enum value `ModifyCommercially` from the `query` request parameter `license`
  - removed the enum value `Public` from the `query` request parameter `license`
  - removed the enum value `Share` from the `query` request parameter `license`
  - …1 more

[Operation history](https://skmtc.dev/carsxe/apis/carsxe-api/changes/images/get.md)

---

[API](https://skmtc.dev/carsxe/apis/carsxe-api.md) - [All operations](https://skmtc.dev/carsxe/apis/carsxe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carsxe/apis/carsxe-api/revisions/ed8f6c024239?raw)