# FDA Drug Recalls

The FDA's open record of drug product recalls, newest first — what was recalled, by which firm, why, and under which classification.

- Method: `GET`
- Path: `/v1/fda/drug-recalls`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `limit` | integer | optional | Records per page. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/fda/drug-recalls \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "total": 17876,
    "recalls": [
      {
        "classification": "Class II",
        "status": "Ongoing",
        "product_description": "DICYCLOMINE HYDROCHLORIDE capsules",
        "reason_for_recall": "Failed dissolution specifications",
        "recalling_firm": "Aurobindo Pharma Limited",
        "brand_name": "DICYCLOMINE HYDROCHLORIDE",
        "generic_name": "DICYCLOMINE HYDROCHLORIDE",
        "manufacturer": "Aurobindo Pharma Limited",
        "report_date": "20260812",
        "recall_initiation_date": "20260728",
        "city": "East Windsor",
        "state": "NJ",
        "country": "United States",
        "voluntary_mandated": "Voluntary: Firm initiated",
        "url": "https://open.fda.gov/data/downloads/"
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T16:30:00.000Z",
    "age_seconds": 120,
    "next_update_at": "2026-08-20T17:00:00.000Z"
  }
}
```