Public API · v1
Medicine equivalents as JSON
Free, read-only and CORS-enabled. Build travel-health, pharmacy or telehealth tools on Pillport's pharmacist-reviewed data. No key needed for normal use.
GET/api/v1/equivalent
What a brand is called in another country. Returns candidates when a brand name is ambiguous; add from= to choose.
GET/api/v1/medicines
Every medicine with its generic name, alternate names, drug class and ATC code.
GET/api/v1/medicines/{slug}
One medicine with brands by country, verification status, strengths and regulator sources.
GET/api/v1/countries
Supported countries and their medicine regulators.
GET/api/search-index
A compact name → medicine index for building your own search box.
POST/api/v1/pk/simulate
Run the PK simulator: send a regimen as JSON, get Cmax, trough, half-life, AUC and the concentration curve.
curl -X POST https://pillport.online/api/v1/pk/simulate \
-H "Content-Type: application/json" \
-d '{"route":"oral","dose_mg":1000,"interval_h":6,"n_doses":4,"volume_l":50,"clearance_l_per_h":18,"ka_per_h":1.5,"bioavailability":0.9}'Example response
{
"version": "1.0.0",
"ambiguous": false,
"query": "panadol",
"to": "US",
"medicine": { "slug": "paracetamol", "generic_name": "Paracetamol", "atc_code": "N02BE01", ... },
"target_brands": [{ "name": "Tylenol", "country": "US", "verification_status": "pending", ... }],
"ask_for_generic": null,
"disclaimer": "For information and education only. Not medical advice. ..."
}Rules
- Without a key: 60 requests per minute per IP on
/equivalentand/pk/simulate. List endpoints are CDN-cached. - With a free API key sent as
Authorization: Bearer pp_…: 600 per minute and a monthly quota from your plan. - Show the verification status. Brands marked "pending" are not yet checked against the regulator.
- Link back to the Pillport page (the
urlfield) and keep the disclaimer visible to your users. - Do not present results as medical advice or use them to dose patients.
Machine-readable spec: openapi.json. Need higher limits or a commercial licence? Contact us.
