---
title: "Search recalls, newest published first"
method: GET
path: "/v1/recalls"
---

# Search recalls, newest published first

`GET /v1/recalls`

## Request

- Base URL: `https://recallradar.withglint.app`
- URL: `https://recallradar.withglint.app/v1/recalls`
- Auth: one of:
  - HTTP bearer
  - API key in header `PAYMENT-SIGNATURE`

x402 scheme upto: cap = base + limit × row price, settled on rows returned. API key: metered max(40, rows) row units.

## Query parameters

- `brand` string[]
- `company` string
- `q` string
- `agency` 'fda_food' | 'fda_drug' | 'fda_device' | 'fsis' | 'cpsc'
- `class` string[]
- `status` 'ongoing' | 'terminated' | 'completed' | 'unknown'
- `active` boolean
- `cursor` string
- `since` string, date
- `until` string, date
- `limit` integer

## Response `200`

OK

- RecallList
  - `data` Recall[]
    - `id` string
    - `slug` string
    - `company_slug` string, nullable
    - `agency` string
    - `official_id` string
    - `class` string, nullable
    - `product_raw` string
    - `brand_norm` string, nullable
    - `firm_norm` string, nullable
    - `reason` string, nullable
    - `status` string
    - `initiated_at` string, date, nullable
    - `published_at` string, date, nullable
    - `geography` string[]
    - `identifiers` object[]
      - `kind` string
      - `value` string
    - `source_url` string: The official agency notice. Authoritative.
    - `url` string
    - `company_url` string, nullable
    - `transform_version` string
    - `first_seen_at` string, date-time
    - `updated_at` string, date-time
    - `ingested_at` string, date-time
  - `next_cursor` string, nullable
  - `meta` Meta
    - `count` integer
    - `disclaimer` string
    - `freshness_url` string

## Other responses

- `400`: Invalid filter or cursor
- `401`: Unknown or revoked key
- `402`: Payment required. PAYMENT-REQUIRED header (x402 v2) plus api_key hints in the body.
- `403`: Plan inactive

---

[API](https://skmtc.dev/withglint/apis/recallradar-api.md) · [All operations](https://skmtc.dev/withglint/apis/recallradar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withglint/apis/recallradar-api/revisions/7f21d37fd135?raw)