Docs / Get started

Medifontis API documentation

Medifontis is a REST API over the official medicine registers of 199 countries. Search medicines by name, active ingredient or national code and get records with their source, licence and limitations.

Base URL

Every endpoint lives under one host, is versioned in the path and answers JSON:

https://api.medifontis.com/v1

Your first request

Search a medicine with a country code and a query. This is a real request; the response below is what it returned.

GET /v1/drugs
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=us" \
  --data-urlencode "q=atorvastatin"
Response
{
  "country": "us",
  "results": [
    {
      "country": "us",
      "sourceId": "us.fda.ndc",
      "id": "us:fda:ndc:0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2",
      "kind": "ndc-products",
      "name": "atorvastatin",
      "names": [
        "atorvastatin",
        "ATORVASTATIN CALCIUM TRIHYDRATE"
      ],
      "identifiers": [
        {
          "value": "0078-1371",
          "scheme": "ndc-product"
        },
        {
          "value": "0078-1371-07",
          "scheme": "ndc-package"
        },
        {
          "value": "b0a6d76c-cacb-4499-a18a-c8353db652f2",
          "scheme": "spl-id"
        }
      ],
      "data": {
        "name": "atorvastatin",
        "splId": "b0a6d76c-cacb-4499-a18a-c8353db652f2",
        "labeler": "Novartis Pharmaceuticals Corporation",
        "productId": "0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2",
        "useDomain": "unknown",
        "dosageForm": "POWDER"
      },
      "retrievedAt": "2026-10-20T10:45:50.815Z",
      "sourceUrl": "https://api.fda.gov/download.json",
      "licence": {
        "id": "CC0-1.0",
        "attribution": "U.S. Food and Drug Administration / openFDA"
      }
    }
  ],
  "nextOffset": 2
}

Principles

  • Official sources only. Every record comes from a national regulator, ministry or agency, collected as the publisher released it.
  • Sources stay independent. Medifontis never merges records or relates them by name. Different sources can describe the same medicine.
  • Unknown stays unknown. When a source does not say whether a medicine needs a prescription, is marketed or is reimbursed, the record says unknown rather than guessing.
  • Provenance travels with the data. Each record states its source URL, retrieval time, licence and limitations.