Medifontis
🇪🇸 EN
Get API key

Docs / API reference

Search medicines

GET/v1/drugs

Searches every record of every source in one country by name, active ingredient or identifier. Names match anywhere in the text; identifiers such as AIC, CN, NDC or DIN codes match from their first character. Matching ignores accents and case. Results rank exact matches first, then prefix matches, then other matches, each by record name.

Parameters

country string Required
Two-letter ISO 3166-1 country code, lowercase. Every search is scoped to one country.
q string Required
The text to search for: a name, an active ingredient or an identifier. 3 to 120 characters, matched literally.
limit integer
Number of results to return, from 1 to 50. Defaults to 20.
offset integer
Number of results to skip, from 0 to 10000. Use the nextOffset of the previous page.
kinds string
Keep only these record kinds, as comma-separated sourceId:kind pairs of the requested country, at most 12. Applied before pagination.
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.
results Record[]
The matching records, best matches first.
nextOffset integer | null
The offset of the next page, or null on the last page.

Errors

400 401 403 429 503 · Errors and rate limits

GET /v1/drugs 
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=es" \
  --data-urlencode "q=enantyum"
Response 
{
  "country": "es",
  "results": [
    {
      "country": "es",
      "sourceId": "es.aemps.cima",
      "id": "es:cima:medicines:60927",
      "kind": "medicines",
      "name": "ENANTYUM 12,5 mg COMPRIMIDOS",
      "data": {
        "form": "COMPRIMIDO RECUBIERTO",
        "name": "ENANTYUM 12,5 mg COMPRIMIDOS",
        "holder": "Laboratorios Menarini S.A.",
        "smpcUrl": "https://cima.aemps.es/cima/pdfs/ft/60927/FT_60927.pdf",
        "doseText": "12,5 mg",
        "marketed": true,
        "documents": [
          {
            "url": "https://cima.aemps.es/cima/pdfs/ft/60927/FT_60927.pdf",
            "type": 1,
            "htmlUrl": "https://cima.aemps.es/cima/dochtml/ft/60927/FT_60927.html",
            "modifiedAtEpochMs": 1761781853000
          },
          {
            "url": "https://cima.aemps.es/cima/pdfs/p/60927/P_60927.pdf",
            "type": 2,
            "htmlUrl": "https://cima.aemps.es/cima/dochtml/p/60927/P_60927.html",
            "modifiedAtEpochMs": 1761781866000
          }
        ],
        "useDomain": "human",
        "leafletUrl": "https://cima.aemps.es/cima/pdfs/p/60927/P_60927.pdf",
        "nationalCode": null,
        "supplyRegime": "Medicamento Sujeto A Prescripción Médica",
        "regionalRules": "not-collected",
        "supplyProblem": false,
        "targetSpecies": [],
        "nonSubstitutable": {
          "id": 0,
          "nombre": "N/A"
        },
        "activeIngredients": null,
        "useDomainEvidence": {
          "basis": "publisher-dataset-scope",
          "field": "sourceId",
          "value": "es.aemps.cima",
          "version": 1,
          "sourceId": "es.aemps.cima"
        },
        "patientEligibility": "not-assessed",
        "registrationNumber": "60927",
        "targetSpeciesStatus": "not-applicable",
        "administrationRoutes": [
          {
            "id": 48,
            "nombre": "VÍA ORAL"
          }
        ],
        "administrativeStatus": "authorised",
        "prescriptionCategory": "prescription-or-restricted",
        "prescriptionRequired": true,
        "activeIngredientsText": null,
        "administrativeStatusScope": "medicine",
        "administrativeDatesEpochMs": {
          "aut": 828309600000
        }
      },
      "region": null,
      "retrievedAt": "2026-10-20T04:47:41.074Z",
      "sourceUrl": "https://cima.aemps.es/cima/rest",
      "licence": {
        "id": "LicenseRef-AEMPS-CIMA-REST",
        "url": "https://sede.aemps.gob.es/datos-abiertos/",
        "scope": "CIMA REST metadata; not the separately restricted Nomenclátor bulk database",
        "termsUrl": "https://www.aemps.gob.es/aviso-legal/",
        "reviewedAt": "2026-09-24",
        "attribution": "Fuente de la información: Agencia Española de Medicamentos y Productos Sanitarios www.aemps.gob.es",
        "documentsIncluded": false
      },
      "limitations": [
        "Complete unfiltered human-medicine registrations and presentations currently exposed by CIMA, not a historical archive of all Spanish authorisations.",
        "Two identical full passes detect observed drift but CIMA supplies no point-in-time snapshot guarantee.",
        "Authorisation, marketing, prescription requirement and patient/prescriber eligibility are separate facts.",
        "Autonomous-community reimbursement, dispensing pathways, treatment plans and patient eligibility are not collected.",
        "Official document URLs and their supplied modification dates only; no document content or images are redistributed.",
        "REST reuse relies on the AEMPS open-data listing and website notice, not a Creative Commons licence or the Nomenclátor bulk terms."
      ],
      "names": [
        "ENANTYUM 12,5 mg COMPRIMIDOS"
      ],
      "identifiers": [
        {
          "value": "60927",
          "scheme": "registration"
        }
      ]
    }
  ],
  "nextOffset": 2
}