# FDA Device Clearances and Approvals (`fda.device_clearances`)

FDA medical device marketing decisions: 510(k) clearances and PMA approvals with supplements, by applicant, product code, device name and decision date, newest first.

Docs: https://primaryapi.com/docs/api-reference/fda/device_clearances

- Endpoint: `POST https://api.primaryapi.com/v1/run/fda.device_clearances`
- Category: Compliance & Records · Platform: `fda` · Kind: list · Status: live
- Price: 1 credit per call. Every call costs the same, including calls that were retried automatically.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=fda.device_clearances`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `pathway` | enum | no |  | one of: 510k, pma | Only 510(k) clearances or only PMA approvals. Omit for both, merged newest first. |
| `applicant` | string | no |  | max 120 chars | Applicant (company) name, phrase match, for example "Medtronic". |
| `productCode` | string | no |  | pattern: ^[A-Za-z]{3}$ | Three-letter FDA device product code, for example "NXC" (sequential aligners). |
| `deviceName` | string | no |  | max 120 chars | Device name, phrase match: the 510(k) device name, or the PMA trade name or generic name. |
| `number` | string | no |  | pattern: ^(K\d{6}\|DEN\d{6}\|P\d{6})$ | Exact decision number: a 510(k) number such as "K263860" (or De Novo "DEN…") or a PMA number such as "P960009" (all of its supplements). |
| `dateFrom` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only records whose decision date is on or after this date (YYYY-MM-DD). Default: 90 days before dateTo. |
| `dateTo` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only records whose decision date is on or before this date (YYYY-MM-DD). Default: today (UTC). |
| `limit` | integer | no | 25 | 1–100 | Maximum number of results to return (1-100, default 25). |
| `cursor` | string | no |  |  | Opaque pagination cursor: pass the previous response's nextCursor. |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `decisions` | object[] | Matching decisions, newest decision date first |
| `decisions[].pathway` | enum | Premarket pathway |
| `decisions[].number` | string | 510(k) number (K…/DEN…) or PMA number (P…) |
| `decisions[].supplementNumber` | string \| null | PMA supplement number, e.g. "S548"; null for an original PMA or a 510(k) |
| `decisions[].applicant` | string \| null |  |
| `decisions[].deviceName` | string \| null | 510(k) device name or PMA trade name |
| `decisions[].genericName` | string \| null | Generic device name (PMA) or the product-code device name (510(k)) |
| `decisions[].productCode` | string \| null | Three-letter FDA product code |
| `decisions[].deviceClass` | string \| null | Device class 1, 2 or 3 of the product code |
| `decisions[].regulationNumber` | string \| null | 21 CFR regulation number of the product code, e.g. "872.5470" |
| `decisions[].advisoryCommittee` | string \| null | Review advisory committee (medical specialty) |
| `decisions[].decisionDate` | string | Decision date, YYYY-MM-DD |
| `decisions[].dateReceived` | string \| null | Date FDA received the submission, YYYY-MM-DD |
| `decisions[].decisionCode` | string \| null | FDA decision code, e.g. SESE (substantially equivalent), APPR, OK30 |
| `decisions[].decisionDescription` | string \| null | 510(k) decision in words, e.g. "Substantially Equivalent"; null for PMA |
| `decisions[].reviewType` | string \| null | 510(k) clearance type (Traditional, Special, Abbreviated) or PMA supplement type |
| `decisions[].supplementReason` | string \| null | Why a PMA supplement was filed; null otherwise |
| `decisions[].expeditedReview` | boolean \| null |  |
| `decisions[].thirdPartyReview` | boolean \| null | 510(k) reviewed by an accredited third party |
| `decisions[].summaryType` | string \| null | 510(k) "Summary" or "Statement" |
| `decisions[].city` | string \| null |  |
| `decisions[].state` | string \| null |  |
| `decisions[].country` | string \| null | Applicant country code (510(k) only) |
| `nextCursor` | string \| null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

Pagination: pass the previous response’s `nextCursor` as `cursor` to get the next page; `nextCursor: null` means there are no more results.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/fda.device_clearances" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pathway":"510k","number":"K263860","dateFrom":"2026-10-30","dateTo":"2026-10-30"}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "decisions": [
        {
          "pathway": "510k",
          "number": "K263860",
          "supplementNumber": null,
          "applicant": "Hangzhou SHINING3D Dental Technology Co., Ltd.",
          "deviceName": "Shining3D Clear Aligner System",
          "genericName": "Aligner, Sequential",
          "productCode": "NXC",
          "deviceClass": "2",
          "regulationNumber": "872.5470",
          "advisoryCommittee": "Dental",
          "decisionDate": "2026-10-30",
          "dateReceived": "2026-10-29",
          "decisionCode": "SESE",
          "decisionDescription": "Substantially Equivalent",
          "reviewType": "Traditional",
          "supplementReason": null,
          "expeditedReview": null,
          "thirdPartyReview": true,
          "summaryType": "Summary",
          "city": "Hangzhou",
          "state": null,
          "country": "CN"
        }
      ],
      "nextCursor": null
    }
  },
  "provider": "PrimaryAPI",
  "credits": 1,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
  "nextCursor": null
}
```

## Pricing and reliability

- Usual price: 1 credit per call
- Price ceiling: the usual price, even when a call is retried. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=fda.device_clearances`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

FDA device decisions, refreshed weekly. Newest decision date first, ties by number then supplement (descending), so the order is stable between runs. Filters combine with AND. Without dateFrom the window is the 90 days up to dateTo (default today, UTC); the response hint says so. For a monitor, pin dateFrom to a fixed date (for example the day you create it): the output then changes only when a record is added or updated, never because an old one ages out of a rolling window. Paging stops after 25,000 records per pathway. Empty results are free.

## Legal

Data provided by the U.S. Food and Drug Administration (openFDA, https://open.fda.gov), public domain (CC0). openFDA: "Do not rely on openFDA to make decisions regarding medical care. While we make every effort to ensure that data is accurate, you should assume all results are unvalidated." FDA states that enforcement-report data should not be used as a method to collect data to issue alerts to the public, and that it does not update a recall's status after the recall is classified. Not medical advice.

