Docs / Guides

Search medicines

GET /v1/drugs searches every record of every source in one country by name, active ingredient or identifier.

How matching works

  • Names match anywhere in the text, so part of a brand name finds it.
  • Identifiers match from their first character, so the beginning of a code finds every record whose code starts with it.
  • Accents and case are ignored.
  • The query is literal text, without wildcards or operators, and needs 3 to 120 characters.

Ranking

Exact matches come first, then records whose name starts with the query, then other matches; ties are ordered by record name.

๐Ÿ‡บ๐Ÿ‡ธ Searchable identifiers

These are the identifier schemes of each source of this country (United States):

Source Publisher Records Identifiers
us.fda.animal-drugs
Animal drugs
U.S. Food and Drug Administration, Center for Veterinary Medicine 2,881 us-fda-animal-application us-fda-animal-proprietary-id
us.fda.drugsfda
Drugs@FDA applications
U.S. Food and Drug Administration (openFDA) 29,390 application ndc-product rxcui set-id unii
us.fda.ndc
NDC Directory
U.S. Food and Drug Administration (openFDA) 138,319 rxcui ndc-package ndc-product spl-id unii application set-id
us.fda.unii
Substances (UNII)
U.S. Food and Drug Administration 171,912 unii cas pubchem ema-sms rxcui who-inn
us.nlm.dailymed
DailyMed label index
U.S. National Library of Medicine 159,201 set-id
us.nlm.rxnorm-cpc
RxNorm prescribable content
U.S. National Library of Medicine 874,179 rxcui unii
us.nlm.rxnorm-mappings
RxNorm mappings
U.S. National Library of Medicine 152,023 rxcui set-id

Filter by record kind

A source can publish several kinds of records, such as packages, active ingredients or ATC classes. Pass kinds to keep only the ones your application uses. The filter applies before paging, so other kinds cannot push them off a page.

cURL
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=us" \
  --data-urlencode "q=atorvastatin" \
  --data-urlencode "kinds=us.fda.ndc:ndc-products"

kinds takes up to 12 comma-separated sourceId:kind pairs, all of the requested country. A malformed pair, or one of another country, answers 400.

Filter by use and species

useDomain and species keep only human or veterinary medicines, or only those for a target species. Human and veterinary medicines.

Pagination

limit sets the page size, from 1 to 50 (default 20), and offset skips results, up to 10000. Each response carries nextOffset, the offset of the next page, or null on the last one.

Example

GET /v1/drugs
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=us" \
  --data-urlencode "q=atorvastatin"
Response
{
  "country": "us",
  "results": [
    {
      "country": "us",
      "sourceId": "us.fda.ndc",
      "id": "us:fda:ndc:0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2",
      "kind": "ndc-products",
      "name": "atorvastatin",
      "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"
        }
      ],
      "data": {
        "name": "atorvastatin",
        "splId": "b0a6d76c-cacb-4499-a18a-c8353db652f2",
        "labeler": "Novartis Pharmaceuticals Corporation",
        "productId": "0078-1371_b0a6d76c-cacb-4499-a18a-c8353db652f2",
        "useDomain": "unknown",
        "dosageForm": "POWDER"
      },
      "retrievedAt": "2026-10-20T10:45:50.815Z",
      "sourceUrl": "https://api.fda.gov/download.json",
      "licence": {
        "id": "CC0-1.0",
        "attribution": "U.S. Food and Drug Administration / openFDA"
      }
    },
    {
      "country": "us",
      "sourceId": "us.fda.ndc",
      "id": "us:fda:ndc:70269-300_6d176902-8764-49ae-96f3-dce57fba5d3a",
      "kind": "ndc-products",
      "name": "Atorvastatin",
      "names": [
        "Atorvastatin",
        "ATORVASTATIN CALCIUM TRIHYDRATE"
      ],
      "identifiers": [
        {
          "value": "70269-300",
          "scheme": "ndc-product"
        },
        {
          "value": "70269-300-00",
          "scheme": "ndc-package"
        },
        {
          "value": "6d176902-8764-49ae-96f3-dce57fba5d3a",
          "scheme": "spl-id"
        }
      ],
      "data": {
        "name": "Atorvastatin",
        "splId": "6d176902-8764-49ae-96f3-dce57fba5d3a",
        "labeler": "CENTRIENT PHARMACEUTICALS INDIA PRIVATE LIMITED",
        "productId": "70269-300_6d176902-8764-49ae-96f3-dce57fba5d3a",
        "useDomain": "unknown",
        "dosageForm": "POWDER"
      },
      "retrievedAt": "2026-10-20T10:45:50.815Z",
      "sourceUrl": "https://api.fda.gov/download.json",
      "licence": {
        "id": "CC0-1.0",
        "attribution": "U.S. Food and Drug Administration / openFDA"
      }
    }
  ],
  "nextOffset": 2
}