Medifontis
🇺🇸 EN
Get API key

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=us" \
  --data-urlencode "barcode=300781371079"
Response 
{
  "country": "us",
  "identifiers": [
    {
      "scheme": "gtin",
      "value": "00300781371079"
    }
  ],
  "results": [
    {
      "country": "us",
      "sourceId": "us.fda.ndc",
      "id": "us:fda:ndc:0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2",
      "kind": "ndc-products",
      "name": "atorvastatin",
      "data": {
        "name": "atorvastatin",
        "splId": "b0a6d76c-cacb-4499-a18a-c8353db652f2",
        "labels": [],
        "routes": [],
        "labeler": "Novartis Pharmaceuticals Corporation",
        "finished": false,
        "packaging": [
          {
            "description": "5 kg in 1 BAG (0078-1371-07)",
            "package_ndc": "0078-1371-07",
            "identifierStatus": "well-formed",
            "marketing_start_date": "19-SEP-13"
          }
        ],
        "productId": "0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2",
        "useDomain": "unknown",
        "dosageForm": "POWDER",
        "productNdc": "0078-1371",
        "deaSchedule": null,
        "genericName": "atorvastatin",
        "productType": "BULK INGREDIENT",
        "listingStatus": "present-in-source-snapshot",
        "targetSpecies": [],
        "approvalStatus": "not-established-by-ndc-listing",
        "labelAssociation": "openFDA-harmonized-set-ids; not a product-level approval match",
        "marketingEndDate": null,
        "activeIngredients": [
          {
            "name": "ATORVASTATIN CALCIUM TRIHYDRATE",
            "strength": "1 kg/kg"
          }
        ],
        "applicationNumber": null,
        "marketingCategory": "BULK INGREDIENT",
        "stateRestrictions": {
          "status": "not-collected",
          "observations": []
        },
        "useDomainEvidence": {
          "basis": "unreviewed",
          "field": null,
          "value": null,
          "version": 1,
          "sourceId": "us.fda.ndc"
        },
        "marketingStartDate": "20130919",
        "targetSpeciesStatus": "not-reported",
        "prescriptionCategory": "unknown",
        "harmonizedIdentifiers": {},
        "listingExpirationDate": "20261231"
      },
      "region": null,
      "retrievedAt": "2026-10-20T10:45:50.815Z",
      "sourceUrl": "https://api.fda.gov/download.json",
      "licence": {
        "id": "CC0-1.0",
        "url": "https://open.fda.gov/license/",
        "attribution": "U.S. Food and Drug Administration / openFDA",
        "documentsIncluded": false
      },
      "limitations": [
        "Complete published endpoint, not a claim that FDA lists every medicine used in the US.",
        "NDC listing, marketing category and application-number assertions are not proof of approval.",
        "Tentative approval, discontinued products and historical submissions remain distinct.",
        "Official document links only; linked documents have not been relicensed or mirrored.",
        "No state restrictions, individual eligibility, or prescribing recommendations inferred.",
        "UNII and RxNorm identifiers are source-asserted openFDA harmonization at record scope; arrays do not pair identifiers to individual products or ingredients, and are not GSID/PhPID or substitution evidence."
      ],
      "names": [
        "atorvastatin",
        "ATORVASTATIN CALCIUM TRIHYDRATE"
      ],
      "identifiers": [
        {
          "value": "0078-1371",
          "scheme": "ndc-product"
        },
        {
          "value": "0078-1371-07",
          "scheme": "ndc-package"
        },
        {
          "value": "b0a6d76c-cacb-4499-a18a-c8353db652f2",
          "scheme": "spl-id"
        }
      ],
      "prescribable": true,
      "matches": [
        {
          "value": "0078-1371-07",
          "scheme": "ndc-package"
        }
      ]
    }
  ]
}