Doku / API-Referenz

Den Barcode einer Packung nachschlagen

GET/v1/drugs/barcode

Findet in einem Land die Datensätze, deren eigene Kennungen im gescannten Code einer Packung enthalten sind. Erkannt werden EAN-, UPC- und GTIN-Barcodes, GS1-DataMatrix- und Digital-Link-Codes, der spanische Nationalcode in einer spanischen NTIN, AIC und Code 32 aus Italien, der Schweizer Packungscode in einer 7680-GTIN und der NDC in einem US-amerikanischen UPC. Namen werden nie verglichen; Charge, Verfallsdatum und Seriennummer werden ignoriert. Für ein Land, dessen Quellen keine Packungscodes veröffentlichen, gibt es keine Ergebnisse.

Parameter

country string Erforderlich
Zweistelliger Ländercode nach ISO 3166-1, in Kleinbuchstaben. Jede Suche ist auf ein Land beschränkt.
barcode string Erforderlich
Der gescannte Code genau so, wie der Scanner ihn gelesen hat, 1 bis 512 Zeichen, einschließlich GS1-Gruppentrennzeichen.
limit integer
Anzahl der zurückzugebenden Ergebnisse, von 1 bis 50. Standardwert: 20.
useDomain enum
Nur Datensätze behalten, die ihre Quelle für diese Anwendung einstuft. human und veterinary umfassen auch Produkte, die die Quelle für beide Bereiche kennzeichnet. Wird vor der Paginierung angewendet.

Mögliche Werte: human veterinary both unknown not-applicable

species string
Nur Datensätze mit dieser geprüften Zieltierart behalten, etwa dog, cat, horse oder cattle. Datensätze mit unbekannter oder nicht zugeordneter Tierart werden ausgeschlossen. Wird vor der Paginierung angewendet.

Rückgabe

country string
Das durchsuchte Land.
identifiers Identifier[]
Die aus dem Code gelesenen Packungskennungen, etwa gtin, es-national-code oder it-aic. Leer, wenn der Code keine Packung bezeichnet.
results Record[]
Die Datensätze, die eine dieser Kennungen angeben, verschreibbare zuerst. Jeder hat matches, die Kennungen des Datensatzes, denen der gescannte Code entspricht, und prescribable, wahr für die eigene Packung, Darreichung oder das Produkt des Arzneimittels und nicht für eine Zeile, die nur seinen Code nennt.

Fehler

400 401 403 429 503 · Fehler und Ratenlimits

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"
Antwort
{
  "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"
        }
      ]
    }
  ]
}