Docs / API reference

Look up a pack barcode

GET/v1/drugs/barcode

Finds the records whose own identifiers a scanned pack code carries, in one country. It reads EAN, UPC and GTIN barcodes, GS1 DataMatrix and Digital Link codes, the Spanish national code in a Spanish NTIN, the Italian AIC and Code 32, the Swiss pack code in a 7680 GTIN and the NDC in a US UPC. It never matches names, and lot, expiry and serial numbers are ignored. A country whose sources publish no pack code returns no results.

Parameters

country string Required
Two-letter ISO 3166-1 country code, lowercase. Every search is scoped to one country.
barcode string Required
The scanned code exactly as the scanner read it, 1 to 512 characters, including any GS1 group separators.
limit integer
Number of results to return, from 1 to 50. Defaults to 20.
useDomain enum
Keep only records whose source classifies them for this use. human and veterinary also include products the source marks for both. Applied before pagination.

Possible values: human veterinary both unknown not-applicable

species string
Keep only records with this reviewed target species, such as dog, cat, horse or cattle. Records with unknown or unmapped species are excluded. Applied before pagination.

Returns

country string
The country searched.
identifiers Identifier[]
The pack identities read from the scan, such as gtin, es-national-code or it-aic. Empty when the code identifies no pack.
results Record[]
The records that declare one of those identifiers, prescribable ones first. Each has matches, the identifiers of the record that the scan equals, and prescribable, true for the medicine’s own pack, presentation or product rather than a row that only lists its code.

Errors

400 401 403 429 503 · Errors and rate limits

GET /v1/drugs/barcode
curl -G https://api.medifontis.com/v1/drugs/barcode \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=it" \
  --data-urlencode "barcode=A012745016"
Response
{
  "country": "it",
  "identifiers": [
    {
      "scheme": "it-aic",
      "value": "012745016"
    }
  ],
  "results": [
    {
      "country": "it",
      "sourceId": "it.aifa.packages",
      "id": "it:aifa:packages:012745016",
      "kind": "packages",
      "name": "TACHIPIRINA",
      "data": {
        "aic": "012745016",
        "atc": "N02BE01",
        "form": "Sciroppo",
        "name": "TACHIPIRINA",
        "holder": "AZIENDE CHIMICHE RIUNITE ANGELINI FRANCESCO A.C.R.A.F. S.P.A.",
        "smpcUrl": "https://api.aifa.gov.it/aifa-bdf-eif-be/1.0.0/organizzazione/219/farmaci/12745/stampati?ts=RCP",
        "useDomain": "human",
        "leafletUrl": "https://api.aifa.gov.it/aifa-bdf-eif-be/1.0.0/organizzazione/219/farmaci/12745/stampati?ts=FI",
        "supplyRegime": "Medicinali non soggetti a prescrizione medica ma non da banco",
        "targetSpecies": [],
        "useDomainEvidence": {
          "basis": "publisher-dataset-scope",
          "field": "sourceId",
          "value": "it.aifa.packages",
          "version": 1,
          "sourceId": "it.aifa.packages"
        },
        "packageDescription": "120 mg/5 ml sciroppo> flacone in PET da 120 ml con siringa dosatrice e bicchiere dosatore",
        "targetSpeciesStatus": "not-applicable",
        "administrativeStatus": "Autorizzata",
        "prescriptionCategory": "non-prescription",
        "activeIngredientsText": "PARACETAMOLO"
      },
      "region": null,
      "retrievedAt": "2026-10-20T03:30:57.988Z",
      "sourceUrl": "https://drive.aifa.gov.it/farmaci/confezioni_fornitura.csv",
      "licence": {
        "id": "CC-BY-4.0",
        "url": "https://www.aifa.gov.it/it/copyright",
        "attribution": "Agenzia Italiana del Farmaco (AIFA)",
        "documentsIncluded": false
      },
      "limitations": [
        "Publisher labels this dataset provisional and descriptive.",
        "Authorisation does not establish current marketing or patient-specific eligibility.",
        "Document links do not grant document redistribution rights."
      ],
      "names": [
        "TACHIPIRINA",
        "PARACETAMOLO"
      ],
      "identifiers": [
        {
          "value": "012745016",
          "scheme": "aic"
        },
        {
          "value": "N02BE01",
          "scheme": "atc"
        }
      ],
      "prescribable": true,
      "matches": [
        {
          "value": "012745016",
          "scheme": "aic"
        }
      ]
    }
  ]
}