v1 · REST · JSON

US drug labels in, structured bilingual ePI out.

Lumen ingests FDA Structured Product Labeling (SPL), extracts patient-facing sections, and serves them as clean JSON — in official English and machine-translated, human-reviewed Spanish. CORS-enabled, key-authenticated, ready for your app.

Try the API Read the reference

Base URL

Live coverage

Real-time from GET /v1/stats — the corpus is ingesting now.

Spanish translation coverage

Share of source segments translated into Spanish.

Section pipeline

Patient-facing Spanish sections by status.

Try it

Live call to GET /v1/search with the public demo key.

// Response will appear here

API reference

All public endpoints are GET and CORS-enabled. Send your key as the x-api-key header (except /health and /v1/stats).

Authentication

Public read endpoints use an API key header. Admin endpoints use a bearer token and are not part of this public reference.

curl -H "x-api-key: " \
  "/v1/stats"

Get an API key

Public demo key

Use this read-only key to explore the API right now. It’s scoped to public GET endpoints and rate-limited.

Production keys

Issuance is an admin operation. A platform admin provisions a scoped lmn_live_… key per tenant and configures rate limits. Keys are passed in the x-api-key header on every request.

Request a key from your Lumen administrator with your intended use and volume.
Admin issues a scoped key (read-only by default).
Store it server-side; never ship a production key in client code.