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=it" \
  --data-urlencode "sourceId=it.aifa.packages" \
  --data-urlencode "id=it:aifa:packages:012745016"

const params = new URLSearchParams({ country: 'it', sourceId: 'it.aifa.packages', id: 'it:aifa:packages:012745016' })
const response = await fetch(`https://api.medifontis.com/v1/drugs/record?${params}`, {
  headers: { Authorization: `Bearer ${process.env.MEDIFONTIS_API_KEY}` },
})
if (!response.ok) throw new Error(`Medifontis ${response.status}`)
const { record } = await response.json()

import os

import requests

response = requests.get(
    "https://api.medifontis.com/v1/drugs/record",
    params={"country": "it", "sourceId": "it.aifa.packages", "id": "it:aifa:packages:012745016"},
    headers={"Authorization": f"Bearer {os.environ['MEDIFONTIS_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
record = response.json()["record"]

Response

{
  "country": "it",
  "record": {
    "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"
      }
    ]
  }
}