cpsc-recalls-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['recall_number'], 'properties': {'recall_number': {'type': 'string', 'pattern': '^\\d{5}([a-d])?$', 'description': 'CPSC recall number: 5 digits for 2002â\x80\x93present records, e.g. "25043", or 5 digits plus a letter aâ\x80\x93d for 1998â\x80\x932001 records, e.g. "99003a". Get one from cpsc_search_recalls or cpsc_get_recent results.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['recall_number', 'recall_date', 'last_updated', 'title', 'description', 'cpsc_url', 'consumer_contact', 'hazards', 'remedy_options', 'remedy_instructions', 'products', 'upcs', 'injuries', 'manufacturers', 'importers', 'retailers', 'distributors', 'manufacturer_countries', 'images', 'coordinated_recalls', 'data_quality_notes', 'cpsc_jurisdiction', 'source_note']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'upcs': {'type': 'array', 'items': {'type': 'string', 'description': 'UPC code.'}, 'description': 'UPC codes for this recall (sparse â\x80\x94 ~4% of records have UPCs). CPSC lists UPCs for the recall as a whole, not per product, so on a recall covering several products a UPC cannot be tied to one of them.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'upstream_error', 'upstream_rejected'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: No recall exists with the given recall number. `upstream_error`: The CPSC recall service (saferproducts.gov) was unavailable, timed out, reported a temporary failure reading its recall data, or sent an unreadable response. `upstream_rejected`: CPSC rejected the lookup instead of returning a recall, and it rejects the same request every time. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'title': {'type': 'string', 'description': 'Official recall title.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'caption'], 'properties': {'url': {'type': 'string', 'description': 'Image URL.'}, 'caption': {'type': 'string', 'description': 'Caption describing what the image shows.'}}, 'description': 'An image from the recall notice.', 'additionalProperties': False}, 'description': 'Product and identification images from the recall notice.'}, 'hazards': {'type': 'array', 'items': {'type': 'object', 'required': ['description'], 'properties': {'description': {'type': 'string', 'description': 'What is dangerous about this product.'}}, 'description': 'A hazard associated with this recall.', 'additionalProperties': False}, 'description': 'Hazards â\x80\x94 read this first.'}, 'cpsc_url': {'type': 'string', 'description': 'Official CPSC recall page â\x80\x94 authoritative source for consumers.'}, 'injuries': {'type': 'string', 'description': 'Injury and incident report narrative, e.g. "None reported" or incident count.'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'units_recalled'], 'properties': {'name': {'type': 'string', 'description': 'Product name.'}, 'units_recalled': {'type': 'string', 'description': 'Estimated number of units recalled, e.g. "About 2,500".'}}, 'description': 'A product covered by this recall.', 'additionalProperties': False}, 'description': 'Products covered. A recall may include multiple products. Model numbers are often in the description text, not a structured field.'}, 'importers': {'type': 'array', 'items': {'type': 'string', 'description': 'Importer name.'}, 'description': 'Importer company names.'}, 'retailers': {'type': 'array', 'items': {'type': 'string', 'description': 'Retailer name with sale date range and price.'}, 'description': 'Retailer names with sale date ranges and price.'}, 'description': {'type': ['string', 'null'], 'description': 'Full recall description including product identification details. Model numbers are typically embedded here, not in a structured field. Null when CPSC published the record without a description â\x80\x94 rare, but a genuine record can still be complete otherwise.'}, 'recall_date': {'type': 'string', 'description': 'Date issued, ISO 8601.'}, 'source_note': {'type': 'string', 'description': 'Provenance caveat: recall fields are CPSC record text with HTML markup and character codes converted to plain text, not otherwise edited or verified; check cpsc_url before a consumer-facing decision.'}, 'distributors': {'type': 'array', 'items': {'type': 'string', 'description': 'Distributor name.'}, 'description': 'Distributor company names.'}, 'last_updated': {'type': 'string', 'description': 'Date last published, ISO 8601.'}, 'manufacturers': {'type': 'array', 'items': {'type': 'string', 'description': 'Manufacturer name.'}, 'description': 'Manufacturer names (often empty â\x80\x94 see importers).'}, 'recall_number': {'type': 'string', 'description': 'Recall identifier.'}, 'remedy_options': {'type': 'array', 'items': {'type': 'string', 'description': 'Remedy type.'}, 'description': 'Remedy types available: Refund, Repair, Replace, New Instructions, Dispose, Label, No Remedy Available, Inspect. Often empty â\x80\x94 CPSC classified the remedy on fewer than half its records. Read remedy_instructions when this is empty, and fall back to cpsc_url when that is empty too, rather than reporting that no remedy exists.'}, 'consumer_contact': {'type': ['string', 'null'], 'description': 'Contact information for claiming the remedy. Null when not provided.'}, 'cpsc_jurisdiction': {'type': 'string', 'description': 'Which products CPSC covers and which agencies cover the rest â\x80\x94 food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).'}, 'data_quality_notes': {'type': 'array', 'items': {'type': 'string', 'description': 'One gap found in the CPSC record.'}, 'description': 'Gaps this server observed in the CPSC record â\x80\x94 absent description, absent hazard text, absent product entries. Derived from which fields CPSC left empty, not from any judgement about the recall itself. Empty when nothing is missing.'}, 'coordinated_recalls': {'type': 'array', 'items': {'type': 'string', 'description': 'URL of coordinated recall by another agency.'}, 'description': 'URLs of coordinated recalls by other agencies (e.g., Canada Health).'}, 'remedy_instructions': {'type': 'string', 'description': 'Full remedy instructions â\x80\x94 exactly what a consumer should do and how to claim.'}, 'manufacturer_countries': {'type': 'array', 'items': {'type': 'string', 'description': 'Country of manufacture.'}, 'description': 'Countries of manufacture.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'days': {'type': 'integer', 'default': 30, 'maximum': 365, 'minimum': 1, 'description': 'Look back this many days from today. Defaults to 30. Use 7 for a weekly digest, 90 for a quarterly review.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of recalls to return. Defaults to 20. A page returns fewer when it reaches the 64,000-byte response size budget.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Skip this many recalls in the window before returning results. To page through total_found, raise offset by the number of recalls the previous page returned â\x80\x94 limit, unless that page reached the response size budget. An offset at or past total_found returns an empty result set rather than an error.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['recalls', 'period', 'total_found', 'truncated', 'offset', 'has_more', 'cpsc_jurisdiction', 'source_note']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['upstream_error', 'upstream_rejected'], 'description': 'Machine-readable failure mode. Declared by this tool: `upstream_error`: The CPSC recall service (saferproducts.gov) was unavailable, timed out, reported a temporary failure reading its recall data, or sent an unreadable response. `upstream_rejected`: CPSC rejected the request instead of returning recalls, and it rejects the same request every time. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Present when the page needs explaining: a window with no recalls (with a larger days to try), an offset past the last recall, or a page cut short by the response size budget (with the offset to continue from).'}, 'offset': {'type': 'number', 'description': 'Number of recalls skipped before this window.'}, 'period': {'type': 'object', 'required': ['start', 'end', 'days'], 'properties': {'end': {'type': 'string', 'description': 'End date (today), ISO 8601.'}, 'days': {'type': 'number', 'description': 'Window length in days.'}, 'start': {'type': 'string', 'description': 'Start date of the query window, ISO 8601.'}}, 'description': 'Date range queried.', 'additionalProperties': False}, 'recalls': {'type': 'array', 'items': {'type': 'object', 'required': ['recall_number', 'recall_date', 'title', 'hazards', 'remedy_options', 'products', 'cpsc_url', 'data_quality_notes'], 'properties': {'title': {'type': 'string', 'description': 'Recall title.'}, 'hazards': {'type': 'array', 'items': {'type': 'string', 'description': 'Hazard description.'}, 'description': 'What is dangerous.'}, 'cpsc_url': {'type': 'string', 'description': 'Official CPSC recall page URL.'}, 'products': {'type': 'array', 'items': {'type': 'string', 'description': 'Product name.'}, 'description': 'Product names recalled.'}, 'recall_date': {'type': 'string', 'description': 'Date issued, ISO 8601.'}, 'recall_number': {'type': 'string', 'description': 'Recall identifier. Pass to cpsc_get_recall for full detail.'}, 'remedy_options': {'type': 'array', 'items': {'type': 'string', 'description': 'Remedy type.'}, 'description': 'Remedy types: Refund, Repair, Replace, New Instructions, Dispose, Label, No Remedy Available, Inspect. Multiple may apply. Often empty â\x80\x94 CPSC classified the remedy on fewer than half its records; call cpsc_get_recall for the remedy instructions when this is empty.'}, 'data_quality_notes': {'type': 'array', 'items': {'type': 'string', 'description': 'One gap found in the CPSC record.'}, 'description': 'Gaps this server observed in the CPSC record â\x80\x94 absent hazard text, absent product entries. Derived from which fields CPSC left empty, not from any judgement about the recall itself. Empty when nothing is missing.'}}, 'description': 'A recent CPSC recall.', 'additionalProperties': False}, 'description': 'Recent recalls, newest-first.'}, 'has_more': {'type': 'boolean', 'description': 'True when recalls remain past this window â\x80\x94 call again with offset raised by the number of recalls returned.'}, 'truncated': {'type': 'boolean', 'description': 'True when recalls in the window remain past this page â\x80\x94 always equal to has_more.'}, 'source_note': {'type': 'string', 'description': 'Provenance caveat: recall fields are CPSC record text with HTML markup and character codes converted to plain text, not otherwise edited or verified; check cpsc_url before a consumer-facing decision.'}, 'total_found': {'type': 'number', 'description': 'Total recalls in this period, counted before offset, limit, and the response size budget narrow the window.'}, 'cpsc_jurisdiction': {'type': 'string', 'description': 'Which products CPSC covers and which agencies cover the rest â\x80\x94 food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of recalls to return on this page. Defaults to 20. A page returns fewer when it reaches the 64,000-byte response size budget; has_more then says more remain.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Skip this many matching records before returning results. To page through total_found, raise offset by the number of recalls the previous page returned â\x80\x94 limit, unless that page reached the response size budget. An offset at or past total_found returns an empty result set rather than an error.'}, 'remedy': {'type': 'string', 'maxLength': 500, 'description': 'Keyword search within the free-text remedy instructions, e.g. "repair", "refund", "firmware update"; matches instructions containing every word, in any order. This searches the remedy text, not the remedy_options categories â\x80\x94 "repair" matches records whose remedy_options list only "Refund" but whose instructions describe a free repair kit. Combines with the other filters using AND; use hazard_search instead to match remedy text as one of several fields.'}, 'date_end': {'anyOf': [{'type': 'string', 'const': ''}, {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$', 'description': 'ISO 8601 date: "YYYY-MM-DD".'}], 'description': 'Include only recalls on or before this date. ISO 8601 format: "YYYY-MM-DD". Must be a real calendar date, and on or after date_start.'}, 'importer': {'type': 'string', 'maxLength': 500, 'description': 'Importer company name. Matches recalls whose importer names contain every word, in any order. Use when searching for recalls by the company that brought the product into the US.'}, 'retailer': {'type': 'string', 'maxLength': 500, 'description': 'Retailer name, e.g. "Walmart", "Target", "Amazon". Matches recalls whose retailer text (store name, dates sold, and price) contains every word, in any order.'}, 'date_start': {'anyOf': [{'type': 'string', 'const': ''}, {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$', 'description': 'ISO 8601 date: "YYYY-MM-DD".'}], 'description': 'Include only recalls on or after this date. ISO 8601 format: "YYYY-MM-DD". Must be a real calendar date â\x80\x94 "2026-02-31" and "2026-99-99" are rejected.'}, 'distributor': {'type': 'string', 'maxLength': 500, 'description': 'Distributor company name, e.g. "Walmart", "Costco". Matches recalls whose distributor names contain every word, in any order â\x80\x94 a role distinct from retailer and importer, and listed on far fewer recalls.'}, 'updated_end': {'anyOf': [{'type': 'string', 'const': ''}, {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$', 'description': 'ISO 8601 date: "YYYY-MM-DD".'}], 'description': 'Include only recalls last published by CPSC on or before this date. ISO 8601 format: "YYYY-MM-DD". Must be a real calendar date, and on or after updated_start.'}, 'manufacturer': {'type': 'string', 'maxLength': 500, 'description': 'Manufacturer name, e.g. "Samsung", "LEGO". Matches recalls whose manufacturer names contain every word, in any order. Many recalls name the importer, retailer, or distributor rather than the manufacturer â\x80\x94 try those filters when this finds nothing.'}, 'product_name': {'type': 'string', 'maxLength': 500, 'description': 'Product name to search for, e.g. "crib", "space heater", "bicycle". Matches recalls whose product names contain every word, in any order â\x80\x94 partial words work.'}, 'title_search': {'type': 'string', 'maxLength': 500, 'description': 'Keyword search within the recall title, e.g. "chandelier", "space heater", "Graco crib". Matches titles containing every word, in any order. CPSC titles name the brand, the product, and the hazard, which makes this the highest-signal single filter for most searches.'}, 'hazard_search': {'type': 'string', 'maxLength': 500, 'description': 'Hazard or safety-concept keyword, e.g. "fire", "choking", "burn", "tip-over dresser". Matches when every word appears in the hazard descriptions, product names, or remedy instructions â\x80\x94 each word in any of the three, in any order, case-insensitive. The filter to use for hazard types; combine it with another filter to narrow a broad hazard.'}, 'updated_start': {'anyOf': [{'type': 'string', 'const': ''}, {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$', 'description': 'ISO 8601 date: "YYYY-MM-DD".'}], 'description': 'Include only recalls last published by CPSC on or after this date. ISO 8601 format: "YYYY-MM-DD". A separate axis from date_start: a 2003 recall re-published in 2025 matches updated_start "2025-01-01". Use to answer "what has CPSC updated recently". Must be a real calendar date.'}, 'description_search': {'type': 'string', 'maxLength': 500, 'description': 'Keyword search within the recall description only â\x80\x94 not the title, hazard text, or remedy instructions; matches descriptions containing every word, in any order. Use for product details not captured in product_name â\x80\x94 model numbers, colors, sale channels. For hazard concepts, prefer hazard_search; for the recall headline, prefer title_search.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['recalls', 'total_found', 'truncated', 'offset', 'has_more', 'cpsc_jurisdiction', 'source_note', 'effectiveQuery']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['missing_criteria', 'invalid_date_range', 'upstream_error', 'upstream_rejected'], 'description': 'Machine-readable failure mode. Declared by this tool: `missing_criteria`: No search criterion was given: every text filter was omitted or blank and no date bound was set. `invalid_date_range`: date_start is later than date_end, or updated_start is later than updated_end, so the range can never match. `upstream_error`: The CPSC recall service (saferproducts.gov) was unavailable, timed out, reported a temporary failure reading its recall data, or sent an unreadable response. `upstream_rejected`: CPSC rejected the request instead of returning recalls, and it rejects the same request every time. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Present when the page needs explaining: zero matches (with which criterion to relax), an offset past the last match, or a page cut short by the response size budget (with the offset to continue from).'}, 'offset': {'type': 'number', 'description': 'Number of matching records skipped before this window.'}, 'recalls': {'type': 'array', 'items': {'type': 'object', 'required': ['recall_number', 'recall_date', 'title', 'hazards', 'remedy_options', 'remedy_summary', 'products', 'upcs', 'manufacturers', 'importers', 'retailers', 'cpsc_url', 'images', 'data_quality_notes'], 'properties': {'upcs': {'type': 'array', 'items': {'type': 'string', 'description': 'UPC code.'}, 'description': 'UPC codes for this recall (sparse â\x80\x94 ~4% of records have UPCs). CPSC lists UPCs for the recall as a whole, not per product, so on a recall covering several products a UPC cannot be tied to one of them.'}, 'title': {'type': 'string', 'description': 'Official recall title.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'caption'], 'properties': {'url': {'type': 'string', 'description': 'Image URL.'}, 'caption': {'type': 'string', 'description': 'Image caption.'}}, 'description': 'An image from the recall notice.', 'additionalProperties': False}, 'description': 'Product images from the recall notice.'}, 'hazards': {'type': 'array', 'items': {'type': 'string', 'description': 'Hazard description â\x80\x94 what is dangerous.'}, 'description': 'Hazard descriptions â\x80\x94 what is dangerous about this product.'}, 'cpsc_url': {'type': 'string', 'description': 'Official CPSC recall page URL for human verification.'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'units_recalled'], 'properties': {'name': {'type': 'string', 'description': 'Product name.'}, 'units_recalled': {'type': 'string', 'description': 'Estimated number of units recalled, e.g. "About 2,500".'}}, 'description': 'A product covered by this recall.', 'additionalProperties': False}, 'description': 'Products covered by this recall. A recall may cover multiple products.'}, 'importers': {'type': 'array', 'items': {'type': 'string', 'description': 'Importer name.'}, 'description': 'Importer company names.'}, 'retailers': {'type': 'array', 'items': {'type': 'string', 'description': 'Retailer name and sale details.'}, 'description': 'Retailer names and sale details (narrative text including stores, dates, price range).'}, 'recall_date': {'type': 'string', 'description': 'Date the recall was issued, ISO 8601.'}, 'manufacturers': {'type': 'array', 'items': {'type': 'string', 'description': 'Manufacturer name.'}, 'description': 'Manufacturer names. Often empty â\x80\x94 importer or retailer may be listed instead.'}, 'recall_number': {'type': 'string', 'description': 'Recall identifier (5-digit numeric for 2002+ records, e.g. "25043"; 6-char with letter suffix for 1998â\x80\x932001 records, e.g. "99003a"). Pass to cpsc_get_recall for full detail.'}, 'remedy_options': {'type': 'array', 'items': {'type': 'string', 'description': 'Remedy type.'}, 'description': 'Remedy types: Refund, Repair, Replace, New Instructions, Dispose, Label, No Remedy Available, Inspect. Multiple may apply. Often empty â\x80\x94 CPSC classified the remedy on fewer than half its records; read remedy_summary when this is empty, and cpsc_url when that is empty too.'}, 'remedy_summary': {'type': 'string', 'description': 'Full remedy instructions â\x80\x94 what the consumer should do and how to claim.'}, 'data_quality_notes': {'type': 'array', 'items': {'type': 'string', 'description': 'One gap found in the CPSC record.'}, 'description': 'Gaps this server observed in the CPSC record â\x80\x94 absent hazard text, absent product entries. Derived from which fields CPSC left empty, not from any judgement about the recall itself. Empty when nothing is missing.'}}, 'description': 'A CPSC recall record.', 'additionalProperties': False}, 'description': 'Matching recalls, ordered newest-first.'}, 'has_more': {'type': 'boolean', 'description': 'True when records remain past this window â\x80\x94 call again with offset raised by the number of recalls returned.'}, 'truncated': {'type': 'boolean', 'description': 'True when matching records remain past this page â\x80\x94 always equal to has_more.'}, 'source_note': {'type': 'string', 'description': 'Provenance caveat: recall fields are CPSC record text with HTML markup and character codes converted to plain text, not otherwise edited or verified; check cpsc_url before a consumer-facing decision.'}, 'total_found': {'type': 'number', 'description': 'Total matching records, counted after every filter is applied and before offset, limit, and the response size budget narrow the window.'}, 'effectiveQuery': {'type': 'string', 'description': 'The search criteria as applied, joined with AND: each non-blank text filter trimmed, the hazard alias resolved to hazard_search, and blank date bounds dropped.'}, 'cpsc_jurisdiction': {'type': 'string', 'description': 'Which products CPSC covers and which agencies cover the rest â\x80\x94 food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).'}}, 'additionalProperties': False}