# searchHealthCanadaDrugProducts

**Identifier:** `healthcanada_searchHealthCanadaDrugProducts`

**Provider:** [Health Canada Drug Product Database](https://kirha.com/providers/healthcanada.md)

Search the Health Canada Drug Product Database (every drug product authorised in Canada, current or cancelled) by brand name, active ingredient (INN), company, DIN, ATC code, status and date of the latest status change. Returns DIN, company, status with its date, first market date, ingredients with strengths and ATC codes. Use statusChangedAfter with status approved or marketed for 'what was newly authorised or launched in Canada since' questions, and getHealthCanadaDrugProduct for dosage form, route, schedule and packaging.

## Run it with the CLI

```bash
kirha tools run healthcanada_searchHealthCanadaDrugProducts \
  --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": "healthcanada_searchHealthCanadaDrugProducts",
  "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": {
    "activeSubstance": {
      "description": "INN, e.g. pembrolizumab",
      "type": "string"
    },
    "atcCode": {
      "description": "ATC code or prefix, e.g. L01FF",
      "type": "string"
    },
    "brandName": {
      "description": "e.g. Keytruda",
      "type": "string"
    },
    "company": {
      "description": "e.g. Merck Canada",
      "type": "string"
    },
    "din": {
      "description": "8-digit Drug Identification Number, e.g. 02441152",
      "type": "string"
    },
    "drugClass": {
      "default": "human",
      "enum": [
        "human",
        "veterinary",
        "disinfectant",
        "radiopharmaceutical"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "type": "number"
    },
    "offset": {
      "default": 0,
      "minimum": 0,
      "type": "number"
    },
    "sortBy": {
      "default": "statusDate",
      "enum": [
        "statusDate",
        "brandName"
      ],
      "type": "string"
    },
    "status": {
      "items": {
        "enum": [
          "marketed",
          "approved",
          "dormant",
          "cancelledPostMarket",
          "cancelledPreMarket",
          "restrictedAccess"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "statusChangedAfter": {
      "description": "YYYY-MM-DD",
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "drugCodes": {
      "description": "DPD drug codes for getHealthCanadaDrugProduct",
      "items": {
        "type": "number"
      },
      "type": "array"
    },
    "products": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "activeIngredients": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "atcCodes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "brandName": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "descriptor": {
            "type": "string"
          },
          "din": {
            "type": "string"
          },
          "drugClass": {
            "type": "string"
          },
          "drugCode": {
            "type": "number"
          },
          "firstMarketedAt": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "statusDate": {
            "description": "Date the current status took effect",
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "drugCode",
          "brandName",
          "activeIngredients",
          "atcCodes",
          "url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "products",
    "total",
    "drugCodes"
  ],
  "type": "object"
}
```

## Related tools

Other Health Canada Drug Product Database tools that this tool refers to, or that refer to it.

- [`searchHealthCanadaCompanies`](https://kirha.com/providers/healthcanada/searchHealthCanadaCompanies.md)
- [`getHealthCanadaDrugProduct`](https://kirha.com/providers/healthcanada/getHealthCanadaDrugProduct.md)

-----

[All Health Canada Drug Product Database tools](https://kirha.com/providers/healthcanada.md) · [< Back to tools list](https://kirha.com/tools.md)