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=us" \
  --data-urlencode "sourceId=us.fda.ndc" \
  --data-urlencode "id=us:fda:ndc:0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2"

const params = new URLSearchParams({ country: 'us', sourceId: 'us.fda.ndc', id: 'us:fda:ndc:0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2' })
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": "us", "sourceId": "us.fda.ndc", "id": "us:fda:ndc:0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2"},
    headers={"Authorization": f"Bearer {os.environ['MEDIFONTIS_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
record = response.json()["record"]

Response

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