---
title: "Recalls"
method: GET
path: "/recalls"
tags: ["Recalls"]
---

# Recalls

`GET /recalls`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/recalls`
- Auth: API key in query parameter `apikey`

Recalls of vehicles (kind vehicle: cars, trucks, buses, motorcycles, RVs and trailers, plus tires, child car seats and vehicle equipment) since the late 1960s and of consumer products (kind consumer: toys, children's products, furniture, appliances, tools, bicycles and more) since the 1970s, from official public data, newest first. /recalls/{id} gives one recall (by id such as v24v123000 or c26123, or its page name) with its texts and the makes, models and model years it covers.

The answer is {filters, total, limit, offset, sort, order, as_of, rows, about}; as_of gives the newest recall date of each kind. /recalls/{id} answers {recall, vehicles, vehicles_total, about}. Until the first load is finished, lists answer with empty rows and note "Data is being prepared".

## Query parameters

- `kind` string
- `make` string
- `model` string
- `model_year` integer
- `ticker` string
- `hazard` string
- `q` string
- `date_from` string
- `do_not_drive` boolean
- `sort` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

[API](https://skmtc.dev/dataporium/apis/dataporium-data-api.md) · [All operations](https://skmtc.dev/dataporium/apis/dataporium-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataporium/apis/dataporium-data-api/revisions/8bc593179dc8?raw)