openfda_recall_searcher
Search FDA drug recall records for specific drugs, classifications, and statuses. Retrieve recall details including reason, product identification, firm details, and distribution information to analyze safety and compliance
Instructions
Search FDA drug recall records from the Enforcement database.
⚠️ PREREQUISITE: Use the 'think' tool FIRST to plan your research strategy!
Returns recall information including:
- Classification (Class I, II, or III)
- Recall reason and description
- Product identification
- Distribution information
- Recalling firm details
- Current status
Class I = most serious (death/serious harm)
Class II = moderate (temporary/reversible harm)
Class III = least serious (unlikely to cause harm)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | No | Optional OpenFDA API key (overrides OPENFDA_API_KEY env var) | |
| drug | No | Drug name to search for recalls | |
| limit | No | Maximum number of results | |
| page | No | Page number (1-based) | |
| reason | No | Search text in recall reason | |
| recall_class | No | Recall classification (1=most serious, 2=moderate, 3=least serious) | |
| since_date | No | Show recalls after this date (YYYYMMDD format) | |
| status | No | Recall status (ongoing, completed, terminated) |
Input Schema (JSON Schema)
{
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional OpenFDA API key (overrides OPENFDA_API_KEY env var)",
"title": "Api Key"
},
"drug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Drug name to search for recalls",
"title": "Drug"
},
"limit": {
"default": 25,
"description": "Maximum number of results",
"maximum": 100,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"page": {
"default": 1,
"description": "Page number (1-based)",
"minimum": 1,
"title": "Page",
"type": "integer"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Search text in recall reason",
"title": "Reason"
},
"recall_class": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Recall classification (1=most serious, 2=moderate, 3=least serious)",
"title": "Recall Class"
},
"since_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Show recalls after this date (YYYYMMDD format)",
"title": "Since Date"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Recall status (ongoing, completed, terminated)",
"title": "Status"
}
},
"title": "openfda_recall_searcherArguments",
"type": "object"
}