---
title: "Search vehicle exterior colors"
method: GET
path: "/api/exterior-colors/v2"
tags: ["Colors (Exterior)"]
---

# Search vehicle exterior colors

`GET /api/exterior-colors/v2`

The demo dataset contains model years 2015 - 2020. To access years 1900 - today please purchase
a [Premium Subscription](/pricing). You must include a valid JWT in the header once you have
purchased a subscription otherwise you will continue to receive the demo dataset.

For complex queries you may use the json field to send an array of URL encoded JSON conditions, example:

`[{"field": "color", "op": "in", "val": ["red", "blue"]}]`

JSON operators: `=`, `!=`, `>`, `<`, `>=`, `<=`, `in`, `not in`, `like`, `not like`, `not null`, and `is null`.

JSON search fields:
 `year`, `make`, `model`, `series`, `submodel`, `trim`, `description`, `make_id`, `model_id`, `submodel_id`, `trim_id`, `color`, `rgb`, `modified`, and `created`.

## Query parameters

- `year` string — Value
- `make` string — Value
- `model` string — Value
- `series` string — Value
- `submodel` string — Value
- `trim` string — Like
- `description` string — Like
- `make_id` string — Value
- `model_id` string — Value
- `submodel_id` string — Value
- `trim_id` string — Value
- `color` string — Value
- `rgb` string — Value
- `json` string — JsonSearchFilter

## Parameters

- `#/x-swagger-bake/components/parameters/paginatorPage` — unresolved $ref
- `#/x-swagger-bake/components/parameters/paginatorLimit` — unresolved $ref
- `#/x-swagger-bake/components/parameters/paginatorSort` — unresolved $ref
- `#/x-swagger-bake/components/parameters/paginatorDirection` — unresolved $ref

## Response `200`

- GenericCollection — unresolved $ref

## Other responses

- `400` — BadRequestException
- `405` — MethodNotAllowedException
- `429` — TooManyRequestsException - Max Per Minute: 600
- `503` — ServiceUnavailableException

---

[API](https://skmtc.net/carapi/apis/car-api-documentation.md) · [All operations](https://skmtc.net/carapi/apis/car-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carapi/car-api-documentation/revisions/5331e15a22af/schema)