Skip to content

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.

https://pillport.online/api/v1/equivalent?brand=panadol&to=US

GET/api/v1/medicines

Every medicine with its generic name, alternate names, drug class and ATC code.

https://pillport.online/api/v1/medicines

GET/api/v1/medicines/{slug}

One medicine with brands by country, verification status, strengths and regulator sources.

https://pillport.online/api/v1/medicines/paracetamol

GET/api/v1/countries

Supported countries and their medicine regulators.

https://pillport.online/api/v1/countries

GET/api/search-index

A compact name → medicine index for building your own search box.

https://pillport.online/api/search-index

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 /equivalent and /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 url field) 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.

Stay informed. Travel smarter.

Get updates, new features and educational resources.

For educators & students

Get early access to Pro features, classroom tools and teaching resources.

Join the waitlist