API documentation
Read-only JSON over every record on this site. Free tier: 1,000 requests/month, no credit card.
Quickstart
Authentication
Pass your key as ?key=YOUR_KEY or an Authorization: Bearer YOUR_KEY header. Keys are created instantly - free keys need no signup, paid keys arrive on the post-checkout page.
Endpoints
GET /v1/clearance
List 510(k) clearances, newest first.
| Parameter | Type | Description |
|---|---|---|
| manufacturer | string | Exact applicant name, e.g. Medtronic, Inc. |
| product_code | string | FDA product code, e.g. LZG |
| device_class | string | 1, 2 or 3 |
| since | date | Decision date floor, YYYY-MM-DD |
| limit / offset | int | Pagination; limit max 1,000 |
GET /v1/clearance/:kNumber
One clearance by K-number, e.g. /v1/clearance/K262116.
GET /v1/changes?since=YYYY-MM-DD
Every record created or updated since a timestamp - the feed behind change alerts. Poll it weekly (or daily on Business) to track competitors and product codes.
MCP server - for AI agents
Atlas is a native tool for Claude, ChatGPT, and any MCP-compatible agent. Add this as a custom connector / MCP server:
Streamable HTTP transport, stateless. Tools: search_records, find_predicates, get_clearance, product_code_stats, get_changes. Each tool call counts as one API request against your plan. Machine-readable overview: /llms.txt.
Plans & limits
| Plan | Requests / month | Exports | Alerts |
|---|---|---|---|
| Free | 1,000 | 3 / month | - |
| Pro ($29/mo) | 50,000 | Unlimited | Weekly email + API |
| Business ($149/mo) | 500,000 | Unlimited + dumps | Daily + API |
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid key |
| 402 | Free export limit reached - upgrade at /pricing |
| 429 | Monthly request quota exceeded |
| 503 | Dataset refresh in progress - retry in ~60s (Retry-After header set) |
Rate-limit headers
Every response carries x-ratelimit-limit and x-ratelimit-remaining so your integration can self-throttle.