Rechercher le code-barres d’une boîte

Trouve, dans un pays, les fiches dont les propres identifiants figurent dans le code scanné d’une boîte. Il lit les codes-barres EAN, UPC et GTIN, les codes GS1 DataMatrix et Digital Link, le code national espagnol contenu dans un NTIN espagnol, l’AIC et le Code 32 italiens, le code de conditionnement suisse contenu dans un GTIN 7680 et le NDC contenu dans un UPC américain. Il ne compare jamais les noms, et le lot, la date de péremption et le numéro de série sont ignorés. Un pays dont les sources ne publient aucun code de conditionnement ne renvoie aucun résultat.

Paramètres

country string Obligatoire

Code pays ISO 3166-1 à deux lettres, en minuscules. Chaque recherche porte sur un seul pays.

barcode string Obligatoire

Le code scanné tel que le lecteur l’a lu, de 1 à 512 caractères, séparateurs de groupe GS1 compris.

limit integer

Nombre de résultats à renvoyer, de 1 à 50. 20 par défaut.

useDomain enum

Ne conserve que les fiches que leur source classe pour cet usage. human et veterinary incluent aussi les produits que la source marque pour les deux usages. Appliqué avant la pagination.

Valeurs possibles: human veterinary both unknown not-applicable

species string

Ne conserve que les fiches ayant cette espèce cible vérifiée, comme dog, cat, horse ou cattle. Les fiches dont l’espèce est inconnue ou non mappée sont exclues. Appliqué avant la pagination.

Renvoie

country string

Le pays de la recherche.

identifiers Identifier[]

Les identités de conditionnement lues dans le code, comme gtin, es-national-code ou it-aic. Vide lorsque le code n’identifie aucun conditionnement.

results Record[]

Les fiches qui déclarent l’un de ces identifiants, les prescriptibles en premier. Chacune a matches, les identifiants de la fiche auxquels le code scanné correspond, et prescribable, vrai pour le conditionnement, la présentation ou le produit du médicament lui-même plutôt que pour une ligne qui ne fait que citer son code.

Erreurs

400 401 403 429 503 · Erreurs et limites de requêtes

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