Developers
The GlassScript data API
Normalized, context-enriched CMS Open Payments data over plain JSON: clinician search, seven-year payment trends, percentile benchmarks, and drug and device maker links.
What you get
- Search that works. Typo-tolerant clinician search with state filters, plus drug, device, and company lookups.
- Context, not just totals. Yearly trends across 2019-2025, nature-of-payment breakdowns, and percentile benchmarks against specialty, state, and national peers.
- Product associations. Which drugs and devices payments were associated with (2023-2025), as reported by the paying companies. These are associations, not allocations.
- Provenance on every response. Each payload carries the data version, publication date, and covered years, so downstream displays can always say where a figure came from.
Who it's for
Care navigationShow patients payment context next to provider choices, with the calm framing built in.
Telehealth platformsAdd disclosure context to provider profiles without building an Open Payments pipeline.
Legal and research teamsQuery normalized totals, trends, and benchmarks instead of parsing CMS publication files.
JournalistsCheck a name, pull seven years of figures, and cite the exact data version. Free keys available.
Quickstart
Check the data version and counts. No key needed:
curl https://glasscript.com/api/v1/meta
Search physicians by name, filtered to a state:
curl "https://glasscript.com/api/v1/physicians/search?q=smith&state=TX" \ -H "Authorization: Bearer gsk_your_key"
Fetch one physician's full document: yearly trends, payment natures, company and product breakdowns, and benchmarks:
curl https://glasscript.com/api/v1/physicians/123456 \ -H "Authorization: Bearer gsk_your_key"
Response envelope
Every response wraps its payload in the same envelope. The meta block travels with the data.
{
"data": [
{
"profile_id": 123456,
"npi": "1234567890",
"first_name": "Jane",
"middle_name": "A",
"last_name": "Smith",
"specialty": "Cardiovascular Disease",
"city": "Houston",
"state": "TX",
"total_all": 18240.55,
"total_latest": 2210.4,
"pct_specialty": 84,
"pct_state": 79,
"pct_national": 81,
"links": {
"self": "https://glasscript.com/api/v1/physicians/123456"
}
}
],
"meta": {
"source": "CMS Open Payments",
"program_years": "2019-2025",
"detail_years": "2023-2025",
"as_of": "June 30, 2026",
"version": "2026a",
"note": "Payments are legal and often routine; figures are as reported to CMS.",
"field_notes": {
"total_all": "general + research payments combined (used for ranking)",
"total_latest": "general payments only, latest program year"
}
}
}
Endpoints
| Endpoint | Key | Returns |
|---|---|---|
GET /api/v1/meta | none | Data version, publication date, and entity counts |
GET /api/v1/physicians/search | required | Matching clinicians with totals and percentiles. Params: q, state, limit |
GET /api/v1/physicians/{id} | required | One clinician's full document: trends, natures, companies, products, benchmarks |
GET /api/v1/drugs/search | required | Matching drugs and devices with associated-payment totals. Param: q |
GET /api/v1/drugs/{slug} | required | One drug or device with maker, specialty, and top-recipient context |
GET /api/v1/companies/{slug} | required | One company with yearly totals, products, and specialty mix |
Tiers
| Tier | Daily requests | Best for |
|---|---|---|
| Free | 1,000 per day | Journalists and academics. Request a key by email; tell us what you're working on. |
| Pro | 25,000 per day | Production products: care navigation, telehealth, directories. |
| Partner | Custom | Higher volumes, bulk data, or custom fields. |
Commercial tiers are in pilot. Email hello@glasscript.com for a key.
Ground rules
- Daily limits reset at 00:00 UTC. Responses include
X-RateLimit-LimitandX-RateLimit-Remainingheaders. - Attribute displayed figures to CMS Open Payments via GlassScript, and keep the "as reported to CMS" framing.
- Product-level figures are payments associated with a product, as reported by companies. Describing them as payments "for" a product or "to promote" it overstates what CMS collects.
- Use of the API is subject to our terms.
Source: CMS Open Payments, program years 2019-2025, as reported to CMS by drug and device makers (published June 30, 2026). Drug and device detail covers 2023-2025.