---
title: "One recall with identifiers"
method: GET
path: "/v1/recalls/{id}"
---

# One recall with identifiers

`GET /v1/recalls/{id}`

## Request

- Base URL: `https://api.recallsapi.com`
- URL: `https://api.recallsapi.com/v1/recalls/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `id` string, required

## Response `200`

OK

- Recall
  - `id` string
  - `agency` 'CPSC' | 'FDA' | 'NHTSA' | 'USDA FSIS' | 'US Coast Guard' | 'FAA' | 'HUD' | 'NIOSH' | 'MSHA'
  - `source` 'cpsc' | 'fda_food' | 'fda_drug' | 'fda_device' | 'nhtsa' | 'fsis' | 'uscg' | 'faa' | 'hud' | 'niosh' | 'msha' | 'fda_press' | 'fda_hfcs' | 'fda_ires'
  - `source_id` string: The agency recall number, Federal Register document number, or a stable slug for notices without a number
  - `category` 'consumer_product' | 'food' | 'drug' | 'device' | 'vehicle' | 'vehicle_equipment' | 'tire' | 'child_seat' | 'meat_poultry' | 'boat' | 'aircraft' | 'manufactured_home' | 'respirator' | 'mine_equipment' | 'unclassified' | 'cosmetic' | 'tobacco' | 'biologic' | 'veterinary'
  - `title` string
  - `description` string, nullable
  - `hazard` string, nullable
  - `remedy` string, nullable
  - `classification` string, nullable: FDA and FSIS class (Class I, II, III), NHTSA recall type, Coast Guard recall type (Boat, Engine or equipment), Federal Register document type, or notice type
  - `status` string, nullable
  - `firms` string[]
  - `products` string[]
  - `distribution` string, nullable
  - `units` string, nullable
  - `flags` string[]
  - `recall_date` string, date, nullable
  - `report_date` string, date, nullable
  - `url` string, uri: Agency notice
  - `source_url` string, uri: Machine-readable source record
  - `first_seen` string, date-time: When recallsapi.com first stored this record
  - `as_of` string, date-time: When recallsapi.com last saw this record change
  - `identifiers` object[]
    - `kind` string
    - `value` string
    - `raw` string

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid API key
- `404`: Not found
- `429`: Daily quota reached

---

[API](https://skmtc.dev/recallsapi/apis/recallsapi-com.md) · [All operations](https://skmtc.dev/recallsapi/apis/recallsapi-com/llms.txt) · [OpenAPI document](https://skmtc.dev/recallsapi/apis/recallsapi-com/revisions/2501df40ea54?raw)
