---
canonical_url: "https://docs.composio.dev/toolkits/open_fda"
markdown_url: "https://docs.composio.dev/toolkits/open_fda.md"
product: "platform"
version: null
last_updated: null
---

# openFDA

Query public FDA drug and medical device datasets, including adverse events, labels, approvals, recalls, shortages, and registrations.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 16
- **Triggers:** 0
- **Slug:** `OPEN_FDA`
- **Version:** 00000000_00

## Tools

### Query Device 510(k) Clearances

**Slug:** `OPEN_FDA_QUERY_DEVICE_510K_CLEARANCES`

Search FDA 510(k) premarket notification clearances for medical devices, including applicants, product codes, decision data, and clearance type, or count clearances by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning clearances. |
| `limit` | integer | No | Maximum clearances or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all 510(k) clearances. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device Adverse Events

**Slug:** `OPEN_FDA_QUERY_DEVICE_ADVERSE_EVENTS`

Search FDA MAUDE medical device adverse event reports, including device, patient, event, manufacturer, and narrative data, or count reports by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning reports. |
| `limit` | integer | No | Maximum reports or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all MAUDE reports. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device Classifications

**Slug:** `OPEN_FDA_QUERY_DEVICE_CLASSIFICATIONS`

Search FDA medical device product classifications, including product codes, device class, specialty, regulation, and exemptions, or count classifications by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning classifications. |
| `limit` | integer | No | Maximum classifications or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all device classifications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device COVID-19 Serology Evaluations

**Slug:** `OPEN_FDA_QUERY_DEVICE_COVID19_SEROLOGY_EVALUATIONS`

Search independent US government evaluations of COVID-19 serological test devices and assay results, or count evaluations by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning evaluations. |
| `limit` | integer | No | Maximum evaluations or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all serology evaluations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device PMA Approvals

**Slug:** `OPEN_FDA_QUERY_DEVICE_PMA_APPROVALS`

Search FDA premarket approval applications and supplements for medical devices, including applicants, trade names, product codes, and decision data, or count approvals by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning approvals. |
| `limit` | integer | No | Maximum approvals or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all PMA approvals. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device Recall Enforcement Reports

**Slug:** `OPEN_FDA_QUERY_DEVICE_RECALL_ENFORCEMENT_REPORTS`

Search FDA medical device recall enforcement reports, including classification, status, recalling firm, reason, distribution, and enforcement dates, or count reports by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning reports. |
| `limit` | integer | No | Maximum reports or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all device enforcement reports. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device Recall Records

**Slug:** `OPEN_FDA_QUERY_DEVICE_RECALL_RECORDS`

Search FDA medical device recall records with product, root-cause, corrective-action, contact, and recall-event details, or count recall records by a field; use the enforcement-report action for Recall Enterprise System enforcement classifications and status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning recall records. |
| `limit` | integer | No | Maximum recall records or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all device recall records. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device Registrations and Listings

**Slug:** `OPEN_FDA_QUERY_DEVICE_REGISTRATIONS_AND_LISTINGS`

Search FDA medical device establishment registrations and device listings, including establishment types, products, proprietary names, and premarket numbers, or count records by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning records. |
| `limit` | integer | No | Maximum records or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all registration and listing records. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Device UDI Records

**Slug:** `OPEN_FDA_QUERY_DEVICE_UDI_RECORDS`

Search FDA Global Unique Device Identification Database records by device identifier, brand, model, company, product code, or other fields, or count UDI records by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning UDI records. |
| `limit` | integer | No | Maximum UDI records or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all UDI records. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Drug Adverse Events

**Slug:** `OPEN_FDA_QUERY_DRUG_ADVERSE_EVENTS`

Search FDA FAERS drug adverse event and medication error reports, or count reports by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning reports. |
| `limit` | integer | No | Maximum reports or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all reports. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Drug Labels

**Slug:** `OPEN_FDA_QUERY_DRUG_LABELS`

Search prescription and over-the-counter Structured Product Labeling records, including warnings, indications, ingredients, and dosage text, or count labels by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning labels. |
| `limit` | integer | No | Maximum labels or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all labels. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Drug NDC Directory

**Slug:** `OPEN_FDA_QUERY_DRUG_NDC_DIRECTORY`

Search National Drug Code Directory product and package records by NDC, name, labeler, ingredient, route, or other fields, or count products by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning products. |
| `limit` | integer | No | Maximum products or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all NDC products. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Drug Recall Enforcement Reports

**Slug:** `OPEN_FDA_QUERY_DRUG_RECALL_ENFORCEMENT_REPORTS`

Search FDA drug recall enforcement reports, including classification, status, recalling firm, reason, distribution, and enforcement dates, or count reports by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning reports. |
| `limit` | integer | No | Maximum reports or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all drug enforcement reports. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Drugs@FDA Applications

**Slug:** `OPEN_FDA_QUERY_DRUGS_AT_FDA_APPLICATIONS`

Search Drugs@FDA applications, sponsors, products, and submissions, or count applications by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning applications. |
| `limit` | integer | No | Maximum applications or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Continuation cursor from a previous response's next_cursor. Omit for the first page; pass the returned value back verbatim to fetch the next page. |
| `search` | string | No | openFDA field:value search expression; omit to query all Drugs@FDA applications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Drug Shortages

**Slug:** `OPEN_FDA_QUERY_DRUG_SHORTAGES`

Search current and historical FDA drug shortage records, including status, availability, presentation, company, and update dates, or count shortages by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning shortages. |
| `limit` | integer | No | Maximum shortages or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all shortage records. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Orange Book Drug Products

**Slug:** `OPEN_FDA_QUERY_ORANGE_BOOK_DRUG_PRODUCTS`

Search Orange Book approved drug products and therapeutic-equivalence data, or count products by a field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Offset for direct paging (0-25000); do not combine with cursor. |
| `sort` | string | No | Field and direction in field:asc or field:desc form; use a stable sort for deep paging. |
| `count` | string | No | Field whose unique values to aggregate into term/count buckets instead of returning entries. |
| `limit` | integer | No | Maximum entries or count buckets to return on this page (0-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a prior call; pass it back unchanged and omit skip. |
| `search` | string | No | openFDA field:value search expression; omit to query all Orange Book entries. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
