# FDA Drug API
> Look up FDA drug labels — purpose, indications, dosage, warnings and ingredients — the most-reported adverse reactions for a drug (aggregated from FAERS), and FDA recall and enforcement records. Backed by openFDA. Useful for healthcare, pharmacy, telemedicine and drug-information apps. Not medical advice.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/drug-api/..."
```

## Pricing
- **Free** (Free) — 1,500 calls/Mo, 2 req/s
- **Basic** ($24/Mo) — 40,000 calls/Mo, 6 req/s
- **Pro** ($59/Mo) — 200,000 calls/Mo, 15 req/s
- **Mega** ($189/Mo) — 1,200,000 calls/Mo, 40 req/s

## Endpoints

### Drugs

#### `GET /v1/events` — Top adverse reactions

**Parameters:**
- `drug` (query, required, string) — Brand or generic name Example: `aspirin`
- `limit` (query, optional, string) — Max 1-50 Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/drug-api/v1/events?drug=aspirin&limit=15"
```

**Response:**
```json
{
    "data": {
        "drug": "aspirin",
        "count": 15,
        "reactions": [
            {
                "reports": 38030,
                "reaction": "FATIGUE"
            },
            {
                "reports": 31830,
                "reaction": "DYSPNOEA"
            },
            {
                "reports": 31455,
                "reaction": "NAUSEA"
            },
            {
                "reports": 31181,
                "reaction": "DIARRHOEA"
            },
            {
                "reports": 26658,
                "reaction": "DRUG INEFFECTIVE"
            },
            {
                "reports": 26448,
                "reaction": "DIZZINESS"
            },
            {
                "reports": 23508,
                "reaction": "HEADACHE"
            },
            {
                "reports": 22998,
                "reaction": "OFF LABEL USE"
            },
            {
                "reports": 22150,
                "reaction": "ASTHENIA"
            },
            {
                "reports": 21721,
                "reaction": "FALL"
            },
            {
                "reports": 21657,
                "reaction": "PAIN"
            },
            {
                "reports": 18441,
                "reaction": "PNEUMONIA"
            },
            {
                "reports": 18418,
                "reaction": "VOMITING"
            },
            {
                "reports": 17408,
                "reaction": "DEATH
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/label` — Drug label / package insert

**Parameters:**
- `drug` (query, required, string) — Brand or generic name Example: `ibuprofen`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/drug-api/v1/label?drug=ibuprofen"
```

**Response:**
```json
{
    "data": {
        "drug": "ibuprofen",
        "route": [
            "ORAL"
        ],
        "dosage": "Directions do not take more than directed the smallest effective dose should be used adults and children 12 years and over: take 1 tablet every 4 to 6 hours while symptoms persist if pain or fever does not respond to 1 tablet, 2 tablets may be used do not exceed 6 tablets in 24 hours, unless directed by a doctor children under 12 years: ask a doctor",
        "purpose": "Purpose Pain reliever/fever reducer",
        "warnings": "Warnings Allergy alert: Ibuprofen may cause a severe allergic reaction, especially in people allergic to aspirin. Symptoms may include: rash facial swelling asthma (wheezing) hives skin reddening shock blisters If an allergic reaction occurs, stop use and seek medical help right away. Stomach bleeding warning: This product contains an NSAID, which may cause severe stomach bleeding. The chance is higher if you: take more or for a longer time than directed take a blood thinning (anticoagulant) or steroid drug have had stomach ulcers or bleeding problems have 3 or more alcoholic drinks every day while using this product are age 60 or older take other drugs containing prescription or nonprescription NSAIDs [aspirin, ibuprofen, naproxen, or others] Heart attack and stroke warning: NSAIDs, except aspirin, increase the risk of heart attack, heart failure, and stroke. These can be fatal. The risk is higher if you use more than directed or for longe
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/recalls` — FDA recall records

**Parameters:**
- `drug` (query, required, string) — Brand or generic name Example: `valsartan`
- `limit` (query, optional, string) — Max 1-25 Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/drug-api/v1/recalls?drug=valsartan&limit=10"
```

**Response:**
```json
{
    "data": {
        "drug": "valsartan",
        "count": 10,
        "results": [
            {
                "reason": "GCMP Deviations: FDA analysis confirmed presence of trace amounts of an impurity, N-nitrosodiethylamine (NDEA) found in the API used to manufacture the product.",
                "status": "Ongoing",
                "company": "Mylan Laboratories Limited, (Nashik FDF)",
                "country": "India",
                "product": "Valsartan and Hydrochlorothiazide Tablets, USP 320/25 mg, (a) 90-count bottle (NDC 0378-6325-77), (b) 500-count bottles (NDC 0378-6325-05), Rx Only, Made in India, Manufactured for: Mylan Pharmaceuticals, Inc., Morgantown, WV 26505 U.S.A.",
                "recall_date": "20181204",
                "distribution": "Product was distributed throughout the United States to several major distributors, including Puerto Rico.",
                "classification": "Class II"
            },
            {
                "reason": "GCMP Deviations: FDA analysis confirmed presence of trace amounts of an impurity, N-nitrosodiethylamine (NDEA) found in the API used to manufacture the product.",
                "status": "Ongoing",
                "company": "Mylan Laboratories Limited, (Nashik FDF)",
                "country": "India",
                "product": "Valsartan and Hydrochlorothiazide Tablets, USP 160/25 mg, (a) 90-count bottle (NDC 0378-6323-77), (b) 500-count bottles (NDC 0378-6323-05), Rx Only, Made in India, Manufacture
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/drug-api
OpenAPI spec: https://www.oanor.com/api/drug-api/openapi.json