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
-
countrystring Required - Two-letter ISO 3166-1 country code, lowercase. Every search is scoped to one country.
-
barcodestring Required - The scanned code exactly as the scanner read it, 1 to 512 characters, including any GS1 group separators.
-
limitinteger - Number of results to return, from 1 to 50. Defaults to 20.
-
useDomainenum -
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:
humanveterinarybothunknownnot-applicable -
speciesstring - 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
-
countrystring - The country searched.
-
identifiersIdentifier[] - The pack identities read from the scan, such as gtin, es-national-code or it-aic. Empty when the code identifies no pack.
-
resultsRecord[] - 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
curl -G https://api.medifontis.com/v1/drugs/barcode \
-H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
--data-urlencode "country=it" \
--data-urlencode "barcode=A012745016"const params = new URLSearchParams({ country: 'it', barcode: 'A012745016' })
const response = await fetch(`https://api.medifontis.com/v1/drugs/barcode?${params}`, {
headers: { Authorization: `Bearer ${process.env.MEDIFONTIS_API_KEY}` },
})
if (!response.ok) throw new Error(`Medifontis ${response.status}`)
const { identifiers, results } = await response.json()import os
import requests
response = requests.get(
"https://api.medifontis.com/v1/drugs/barcode",
params={"country": "it", "barcode": "A012745016"},
headers={"Authorization": f"Bearer {os.environ['MEDIFONTIS_API_KEY']}"},
timeout=10,
)
response.raise_for_status()
results = response.json()["results"]
{
"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"
}
]
}
]
}