Medifontis
🇨🇦 EN
Get API key

Docs / API reference

Retrieve a record

GET/v1/drugs/record

Reads exactly one current record by its country, source and native identity, for example to refresh a record your application saved earlier. Answers 404 when the source no longer publishes it.

Parameters

country string Required
Two-letter ISO 3166-1 country code, lowercase. Every search is scoped to one country.
sourceId string Required
The sourceId of the record, which must belong to the requested country.
id string Required
The id of the record exactly as the API returned it, 1 to 300 characters.

Returns

country string
The country of the record.
record Record
The current record with this identity.

Errors

400 401 403 404 429 503 · Errors and rate limits

GET /v1/drugs/record 
curl -G https://api.medifontis.com/v1/drugs/record \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=ca" \
  --data-urlencode "sourceId=ca.health-canada.dpd" \
  --data-urlencode "id=ca:health-canada:products:62265"
Response 
{
  "country": "ca",
  "record": {
    "country": "ca",
    "sourceId": "ca.health-canada.dpd",
    "id": "ca:health-canada:products:62265",
    "kind": "products",
    "name": "METFORMIN · 500 MG per TAB · TABLET",
    "data": {
      "din": "02238827",
      "form": "TABLET",
      "name": "METFORMIN · 500 MG per TAB · TABLET",
      "holder": "LABORATOIRES CONFAB INC",
      "routes": [
        "ORAL"
      ],
      "smpcUrl": null,
      "atcCodes": [
        "A10BA02"
      ],
      "drugCode": "62265",
      "marketed": false,
      "packages": [],
      "brandName": "METFORMIN",
      "updatedAt": "22-MAR-2025",
      "useDomain": "human",
      "descriptor": null,
      "leafletUrl": null,
      "statusDate": "09-APR-2021",
      "biosimilars": [],
      "brandNameFr": null,
      "descriptorFr": null,
      "productClass": "Human",
      "publishedDin": "02238827",
      "sourceStatus": "CANCELLED PRE MARKET",
      "supplyRegime": "PRESCRIPTION",
      "targetSpecies": [],
      "categorization": null,
      "ingredientGroup": "0101773001",
      "publicationDate": "2026-10-05",
      "sourcePartition": "cancelled",
      "dinNotApplicable": false,
      "activeIngredients": [
        {
          "base": "N",
          "code": "10147",
          "name": "METFORMIN HYDROCHLORIDE",
          "unit": "MG",
          "nameFr": "Chlorhydrate de metformine",
          "strength": "500",
          "dosageUnit": "TAB",
          "dosageValue": null,
          "strengthType": null,
          "suppliedIndicator": "I"
        }
      ],
      "useDomainEvidence": {
        "basis": "publisher-field",
        "field": "class",
        "value": "Human",
        "version": 1,
        "sourceId": "ca.health-canada.dpd"
      },
      "identifierWarnings": [],
      "patientEligibility": "not-assessed",
      "numberOfIngredients": "1",
      "targetSpeciesStatus": "not-applicable",
      "administrativeStatus": "cancelled",
      "prescriptionCategory": "prescription-or-restricted",
      "prescriptionRequired": true,
      "pharmaceuticalStandards": []
    },
    "region": null,
    "retrievedAt": "2026-10-20T06:46:39.902Z",
    "sourceUrl": "https://www.canada.ca/en/health-canada/services/drugs-health-products/drug-products/drug-product-database/what-data-extract-drug-product-database.html",
    "licence": {
      "id": "LicenseRef-Health-Canada-DPD-Reuse-Unconfirmed",
      "url": "https://healthycanadians.gc.ca/important-eng.php",
      "reviewedAt": "2026-10-01",
      "attribution": "Source: Health Canada, Drug Product Database (DPD).",
      "documentsIncluded": false
    },
    "limitations": [
      "This is the complete published DPD extract, not the separately licensed natural health products database, the CCDD clinical terminology dataset or provincial formulary eligibility.",
      "The publisher page advertises file dates independently of the products’ own last-update dates; neither is silently replaced by collection time.",
      "Record identity is DRUG_CODE. DINs are verbatim eight-digit strings and can repeat across historical observations; Not Applicable/non applicable is retained but never indexed as a DIN.",
      "Veterinary and disinfectant products are collected as separate kinds and excluded from Doctofam prescriptions. Radiopharmaceuticals retain their own kind.",
      "Schedules C/D, homeopathic and prescription-recommended designations alone do not establish Rx/OTC classification; missing, mixed and unrecognised classifications remain unknown. Ethical is federally non-prescription professional use.",
      "Package descriptions and UPC values are publisher observations, not unique package records. No pack identifier, interchangeability, stock or patient eligibility is inferred.",
      "The actual therapeutic-class export has four columns rather than the current read-me’s seven; the fourth remains raw without an inferred meaning.",
      "Corporate addresses are withheld from normalized and raw records. Original source archives remain retained as evidence. No product monograph URLs are published in these extracts, and no clinical documents are copied.",
      "The linked legacy copyright notice requires permission for commercial reproduction. The Open Government portal also lists this dataset, but its current licence could not be verified during review; commercial derived-data reuse remains unconfirmed and the owner accepts this documented rights gap under the country brief."
    ],
    "names": [
      "METFORMIN · 500 MG per TAB · TABLET",
      "METFORMIN",
      "METFORMIN HYDROCHLORIDE",
      "Chlorhydrate de metformine"
    ],
    "identifiers": [
      {
        "value": "02238827",
        "scheme": "din"
      },
      {
        "value": "62265",
        "scheme": "dpd-drug-code"
      },
      {
        "value": "A10BA02",
        "scheme": "atc"
      },
      {
        "value": "0101773001",
        "scheme": "aig"
      }
    ]
  }
}