---
title: "Get Sub Models for light duty cars, trucks, vans and SUVs."
method: GET
path: "/api/submodels/v2"
tags: ["Sub Models"]
---

# Get Sub Models for light duty cars, trucks, vans and SUVs.

`GET /api/submodels/v2`

The demo dataset contains sub-models sold between years 2015 - 2020. To access years 1900 - today please purchase
a [Plus or 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": "make", "op": "in", "val": ["Ford", "Acura"]}, {"field": "year", "op": ">=", "val": 2010}]`

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

JSON search fields:
 `year`, `make`, `model`, `submodel`, `oem_make_model_id`, `oem_make_model_submodel_id`, `created`, `modified`, and `make_id`.

## Query parameters

- `sort` 'OemMakeModelSubmodels.year' | 'Makes.name' | 'OemMakeModels.name' | 'OemMakeModelSubmodels.name'
- `year` string — Value
- `make` string — Value
- `model` string — Value
- `submodel` string — Value
- `oem_make_model_id` string — Value
- `make_id` string — Value
- `json` string — OemJsonSearchFilter

## Parameters

- `#/x-swagger-bake/components/parameters/paginatorPage` — unresolved $ref
- `#/x-swagger-bake/components/parameters/paginatorLimit` — 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)