Get one recall by agency and slug
get_recallFetch the full Recall Canary record for a single U.S. federal recall, FSIS public health alert or CPSC safety warning (record_kind), given the agency and slug returned by search_recalls. Includes the hazard description, the affected product list with lot codes and UPCs, the recommended consumer action, distribution, the Recall Canary page URL to link when citing it (url), the agency's own notice (source_url), and the firm slug (firm.slug, with firm.page_url when the firm has a page) for search_recalls' firm filter. Also resolves preliminary agency press releases: an orphan, or a linked one that kept its own URL (its recalls in linked_recalls). Read-only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agency": "<agency>",
"slug": "<slug>"
},
"name": "get_recall"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The record slug from its URL, e.g. "acme-foods-peanut-butter". The 26-character ULID id is also accepted and resolves to what its URL shows (for a matched press release, often its recall). | |
| agency | Yes | Lowercase agency segment from the record URL: a search row's `agency` in lower case (`FDA_IRES` is `fda`). Part of the lookup key, not decoration: a correct slug under the wrong agency is a miss. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| url | Yes | The Recall Canary page for this record (absolute, canonical): the plain-language page a reader can use. Link this when you cite the record. | |
| firm | No | ||
| late | No | Since api 2.7.0. Null unless the recall is late: it began more than 184 days before listed_at, or it ended on or before the date its listed_at_basis names. | |
| risk | No | The agency rating as the page shows it (for example "High risk" for an FDA Class I recall). Null where the page shows no risk line. | |
| slug | No | ||
| dates | No | ||
| notes | Yes | Caveats for this record, including the aggregator-lag and not-a-clearance statement. | |
| title | Yes | Agency-published title. Never model-written. Show `display_title` when it is present; it is the plain title the page prints. | |
| agency | Yes | Known values: FDA, FDA_IRES, FSIS, CPSC, NHTSA, ADMIN. | |
| reason | No | The agency's own stated reason, not model-written. | |
| status | No | ||
| license | Yes | Attribution and terms (DATA-LICENSE). | |
| related | No | ||
| category | No | Known values: FOOD, DRUG, BIOLOGIC, DEVICE, COSMETIC, CONSUMER_PRODUCT, VEHICLE, AUTO_EQUIPMENT. | |
| citation | No | How to cite this record: link `page_url` (the Recall Canary page a reader can use) and name `source_url` (the agency's own notice) as the source of record. | |
| html_url | Yes | Absolute URL of the human-readable page. | |
| products | No | ||
| severity | No | Known values: CRITICAL, MODERATE, LOW. | |
| timeline | No | Dated steps of the record, in date order. Each step names who acted on that date. FDA labels: Company began the recall, Announced by the company, Added to FDA's Enforcement Report, Classified by FDA, In FDA's weekly enforcement report; then Listed on Recall Canary, Summary updated, Recall ended, Archived. | |
| canonical | Yes | Absolute URL of this representation. | |
| firm_name | No | ||
| listed_at | No | Since api 2.6.0. The date the listing shows and sorts by; equals this record's search_recalls row. A recall's listing date is in dates.listed_at. | |
| source_url | No | The agency's own notice: the source of record. Name it beside `url` when you cite the record. | |
| api_version | Yes | ||
| description | No | Full agency description. FSIS: sanitized HTML; others: plain text. Sanitize or escape before display. | |
| hazard_tags | Yes | ||
| record_kind | No | Since api 2.12.0. What kind of agency notice a recall record is: `recall`, an FSIS `public_health_alert` or a CPSC `safety_warning`; the last two are not recalls and are never rated. Null on a preliminary record. `record_type` is `recall` on all three; no filter selects by kind. | |
| record_type | Yes | ||
| snapshot_at | Yes | ISO-8601 UTC response-generation time, second precision. First key on purpose. | |
| advisory_url | No | ||
| ai_generated | Yes | Provenance: true where the field holds model-written text. Over-attributes on purpose. | |
| distribution | No | ||
| published_at | No | Deprecated: the stored pub_date. | |
| display_title | No | ||
| mcp_truncated | No | Present only when a long list was cut to 25 for this response. | |
| product_count | No | The true event scope, which may exceed products.length. | |
| story_lead_id | No | Set on a later record of a recall story; the lead it belongs to. | |
| animal_product | No | Since api 2.14.0. Whom an FDA product is for, from FDA's own signals (its veterinary center's V- recall number, or an Animal & Veterinary, Animal Feed or Pet Food product type), never from product names. `category` stays FDA's (pet food is FOOD). Null otherwise. Do not give an animal product human advice. | |
| critical_flags | No | NHTSA-only in practice. An absent key means the agency did not state the flag. null for a withdrawn (RETRACTED) record. | |
| identification | Yes | Page-derived identification: the products and codes the record names. Not a completeness guarantee; `partial` says when the list is incomplete, including when this response cut `products` to 25 (`mcp_truncated.identification_products`). | |
| linked_recalls | No | ||
| press_releases | No | ||
| story_lead_url | No | ||
| units_affected | No | ||
| consumer_action | No | The "What to do" text. Null on a withdrawn alert. On a CPSC safety warning, CPSC's own Consumer Action (its instructions, not a remedy). | |
| display_summary | No | ||
| source_recall_id | No | Agency key; a CPSC one can be stale. | |
| remedy_superseded | No | Since api 2.13.0. A later CPSC safety warning says this recall's remedy is no longer being provided: its page and its sentence that says so (verbatim, or null). `consumer_action` is then that warning's Consumer Action unless an operator pinned one. Null otherwise. | |
| content_changed_at | Yes | When the published content last changed. | |
| products_truncated | No | True when `product_count` exceeds the length of `products` | |
| agency_published_at | No | ||
| company_announced_at | No | ||
| company_product_list | No | The company's own list of the affected products, when the agency notice points to it instead of naming them. A product missing from `identification` may still be recalled: check this list. | |
| display_summary_short | No |