---
title: "Search vehicle bodies"
method: GET
path: "/api/bodies/v2"
tags: ["Bodies"]
---

# Search vehicle bodies

`GET /api/bodies/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": "doors", "op": ">=", "val": 4}, {"field": "type", "op": "in", "val": ["SUV","Van"]}]`

See `/api/vehicle-attributes` for a complete list of vehicle attributes.

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`, `type`, `doors`, `seats`, `length`, `width`, `height`, `wheel_base`, `front_track`, `rear_track`, `ground_clearance`, `cargo_capacity`, `max_cargo_capacity`, `curb_weight`, `gross_weight`, `max_payload`, `max_towing_capacity`, `created`, and `modified`.

## 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
- `type` string — Like
- `doors` 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)