---
title: "Recalls by Year, Make & Model"
method: GET
path: "/v1/recalls-ymm"
tags: ["Recalls"]
---

# Recalls by Year, Make & Model

`GET /v1/recalls-ymm`

Retrieve open safety recalls for a vehicle by year, make, and model — no VIN required.

## Query parameters

- `year` string, required
- `make` string, required
- `model` string, required

## Response `200`

Recall data retrieved.

- object
  - `success` boolean
  - `input` object
    - `year` string
    - `make` string
    - `model` string
  - `data` object
    - `make` string
    - `model` string
    - `model_year` string
    - `recall_count` integer
    - `has_recalls` boolean
    - `recalls` object[]
  - `timestamp` string

## Other responses

- `400` — Missing or invalid year, make, or model.
- `401` — Missing API key, unknown/disabled API key, or inactive account.
- `404` — Feature not available on this plan.
- `429` — API usage limit exceeded for the current billing period.
- `500` — Internal server error.

---

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