# searchMedicines

**Identifier:** `ema_searchMedicines`

**Provider:** [EMA Europa](https://kirha.com/providers/ema.md)

Search and filter across all EMA-authorized medicines by name, active substance, therapeutic area, or any combination of fields. This is the primary entry point for general medicine lookups. Returns the ids field (emaProductNumbers) for composition with other tools.

## Run it with the CLI

```bash
kirha tools run ema_searchMedicines \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "ema_searchMedicines",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "enum": [
        "Human",
        "Veterinary"
      ],
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "number"
    },
    "medicineStatus": {
      "enum": [
        "Authorised",
        "Withdrawn"
      ],
      "type": "string"
    },
    "query": {
      "default": "",
      "description": "Free-text search across medicine name, active substance, therapeutic area, and indication.",
      "type": "string"
    },
    "sortBy": {
      "enum": [
        "marketingAuthorisationDate:desc",
        "marketingAuthorisationDate:asc",
        "lastUpdatedDate:desc"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "atcCodes": {
      "description": "Join key across drug MCPs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "emaProductNumbers": {
      "description": "EMA product numbers for composition with other tools",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "medicines": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "activeSubstance": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "atcCodeHuman": {
            "type": [
              "string",
              "null"
            ]
          },
          "biosimilar": {
            "type": "boolean"
          },
          "category": {
            "type": "string"
          },
          "conditionalApproval": {
            "type": "boolean"
          },
          "emaProductNumber": {
            "type": "string"
          },
          "generic": {
            "type": "boolean"
          },
          "lastUpdatedDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "marketingAuthorisationDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "marketingAuthorisationHolder": {
            "type": [
              "string",
              "null"
            ]
          },
          "medicineStatus": {
            "type": "string"
          },
          "medicineUrl": {
            "type": "string"
          },
          "nameOfMedicine": {
            "type": "string"
          },
          "orphanMedicine": {
            "type": "boolean"
          },
          "pharmacotherapeuticGroupHuman": {
            "type": [
              "string",
              "null"
            ]
          },
          "therapeuticAreaMesh": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "therapeuticIndication": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "nameOfMedicine",
          "emaProductNumber",
          "category",
          "medicineStatus",
          "activeSubstance",
          "therapeuticAreaMesh",
          "orphanMedicine",
          "biosimilar",
          "generic",
          "conditionalApproval",
          "medicineUrl"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "medicines",
    "emaProductNumbers",
    "atcCodes"
  ],
  "type": "object"
}
```

## Related tools

Other EMA Europa tools that this tool refers to, or that refer to it.

- [`getRegulatoryProtection`](https://kirha.com/providers/ema/getRegulatoryProtection.md)

-----

[All EMA Europa tools](https://kirha.com/providers/ema.md) · [< Back to tools list](https://kirha.com/tools.md)