---
title: "List product recalls"
method: GET
path: "/api/recalls"
tags: ["Product recalls"]
---

# List product recalls

`GET /api/recalls`

## Request

- Base URL: `https://noozra.com`
- URL: `https://noozra.com/api/recalls`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/noozra/apis/noozra-news-api/docs/api/recalls/get.ts> (a function with typed inputs; its response is checked against the schema)

Consumer product recalls from the CPSC, and food, drug and device recalls from FDA's enforcement reports. Each item's `date` is the day the recall was announced (CPSC) or reported (FDA). Sort with `sort`; page by passing `next_cursor` back as `cursor`. `as_of` is when the data was last known current. Records dated in the last 14 days for every key; API Pro reaches every record.

## Query parameters

- `q` string
- `category` 'consumer' | 'food' | 'drug' | 'device'
- `classification` '1' | '2' | '3'
- `firm` string
- `state` string
- `after` string, date
- `sort` 'newest'
- `cursor` string
- `limit` integer

## Response `200`

OK

- RecallsResponse
  - `as_of` string, date-time, nullable, required: When this dataset was last known current: the oldest last successful read among its sources (the city's own, with `city`).
  - `count` integer, required
  - `next_cursor` string, nullable, required: Pass as `cursor` for the next page; null at the end.
  - `recalls` Recall[], required
    - `agency` 'CPSC' | 'FDA', required
    - `category` 'consumer' | 'food' | 'drug' | 'device', required
    - `classification` string, nullable, required: FDA's Class I, II or III.
    - `codes` string, nullable, required: Lot and code information (FDA).
    - `date` string, date, required: YYYY-MM-DD: the day the recall was announced (CPSC) or reported (FDA).
    - `description` string, nullable, required: The source's own text, at most 1000 characters.
    - `distribution` string, nullable, required: Where the product was sold or distributed.
    - `event_id` string, nullable, required: FDA's recall event, shared by the reports of one recall.
    - `firm` string, nullable, required: The recalling firm (FDA), or the manufacturers, importers and distributors (CPSC).
    - `firm_country` string, nullable, required
    - `id` string, uuid, required
    - `initiated_date` string, date, nullable, required
    - `made_in` string, nullable, required: Where the product was made (CPSC).
    - `place` Place, required
      - `address` string, nullable, required
      - `city` string, nullable, required
      - `country` string, nullable, required: ISO 3166-1 alpha-3, such as USA.
      - `latitude` number, nullable, required
      - `longitude` number, nullable, required
      - `state` string, nullable, required: Two-letter state.
      - `zip` string, nullable, required
    - `product` string, nullable, required
    - `quantity` string, nullable, required
    - `reason` string, nullable, required: Why the product was recalled (CPSC: the hazard).
    - `reference` string, required: The record's own number at its source.
    - `remedy` string, nullable, required: What consumers should do (CPSC).
    - `source` string, required: Who published the record. Name it when you show the record.
    - `status` string, nullable, required
    - `title` string, nullable, required
    - `url` string, uri, nullable, required: The record at its source; for a city record without a page of its own, the city's dataset.

## Other responses

- `400`: A parameter out of shape (the `error` says which), a sort this dataset does not take, a cursor not given out for this sort, or a date outside 1970–9999
- `401`: No API key, or an invalid or revoked one
- `403`: `after` reaches past the last 14 days: that needs API Pro
- `429`: Daily rate limit exceeded (honor the Retry-After header)

## Changes

- **2026-10-29** `9067da767e84`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/noozra/apis/noozra-news-api/changes/api/recalls/get.md)

---

[API](https://skmtc.dev/noozra/apis/noozra-news-api.md) - [All operations](https://skmtc.dev/noozra/apis/noozra-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/noozra/apis/noozra-news-api/revisions/9067da767e84?raw)