---
title: "Search Canada Vigilance"
method: GET
path: "/v1/sources/canada-vigilance/search"
tags: ["Canada Vigilance"]
---

# Search Canada Vigilance

`GET /v1/sources/canada-vigilance/search`

## Request

- Base URL: `https://api.assyro.com`
- URL: `https://api.assyro.com/v1/sources/canada-vigilance/search`
- Auth: none declared

Search Canada Vigilance, Health Canada's database of suspected adverse reaction reports for health products marketed in Canada (drugs, biologics and vaccines, natural health products, radiopharmaceuticals), from Assyro's copy of Health Canada's monthly data extract (Open Government Licence - Canada), reports from 1965 to the extract's date. Each report: Health Canada's report number, dates received, report type (spontaneous, study, published), patient sex and age, seriousness and its criteria, outcome, reporter type, every product named with its role (suspect, concomitant), active ingredients, dose, route and indication, and the MedDRA reactions. Find by drug (brand or active ingredient; suspect drugs by default), reaction (MedDRA preferred term), system organ class, seriousness, outcome, sex, age or date received; countBy counts every match (top reactions for a drug, reports by year, outcomes), and total is exact. Reports are SUSPECTED associations in the reporter's opinion, not established causation, and counts are not incidence and cannot compare products (Health Canada's caveat comes with every answer: repeat it). For FDA adverse event reports use the openFDA FAERS dataset; for EU ones, search_eudravigilance_reports.

## Query parameters

- `query` string: Words that must all appear among a report's products, active ingredients, indications or reactions, e.g. "semaglutide pancreatitis".
- `drug` string: A brand name or active ingredient, e.g. "Ozempic" or "semaglutide"; matched as a phrase against the report's suspect drugs (or every drug with role "any").
- `role` 'suspect' | 'any': Which drugs `drug` and suspect counts read: "suspect" (default: suspect or interacting) or "any" (concomitant and treatment drugs too).
- `reaction` string: A MedDRA preferred term or words of one, e.g. "Pancreatitis" or "drug-induced liver injury".
- `systemOrganClass` string: A MedDRA system organ class, e.g. "Hepatobiliary disorders".
- `serious` boolean: true: serious reports only (death, life threatening, hospitalization, disability, congenital anomaly or other medically important condition); false: non-serious only.
- `outcome` 'Fatal' | 'Not recovered/not resolved' | 'Recovering/resolving' | 'Recovered/resolved' | 'Recovered/resolved with sequelae' | 'Unknown': The report's outcome as Health Canada words it.
- `sex` 'Female' | 'Male': The patient's sex as reported.
- `ageFrom` number: Patients at least this old, in years (0.5 for six months).
- `ageTo` number: Patients at most this old, in years.
- `receivedFrom` string: Reports Health Canada first received on or after this date, YYYY-MM-DD.
- `receivedTo` string: First received on or before this date, YYYY-MM-DD.
- `excludeDuplicates` boolean: true leaves out reports Health Canada links to another as its duplicate (default false: every report, as the database lists them).
- `countBy` 'reaction' | 'system_organ_class' | 'suspect_ingredient' | 'suspect_product' | 'outcome' | 'sex' | 'report_type' | 'seriousness_criterion' | 'year': Count every match by this field (top 20, or every year), returned as summary lines with the exact total.
- `limit` integer: Reports to return, default 8, newest first. total and countBy cover every match.
- `offset` integer: Skip this many results (for paging), default 0.

## Response `200`

Matching records.

- SearchResponse
  - `version` unknown, required
  - `source` SourceRef, required
    - `id` string, required
    - `label` string, required
    - `authority` string, required
  - `total` integer, nullable, required: Total matches the source reports, when it says.
  - `records` Record[], required
    - `id` string, required: The source's own identifier for the record.
    - `title` string, required
    - `url` string, required: The record's page at the source, to verify it.
    - `authority` string, required: Who published the record.
    - `snippet` string, nullable, required: The part of the record that matched; null where the licence allows only a link.
    - `publishedDate` string, nullable, required
    - `version` string, nullable, required: The edition or revision read.
    - `fields` object, nullable, required: The source's own fields; null where the licence allows only a link.
    - `asOf` string, nullable, required: The day Assyro's copy of the source was read (YYYY-MM-DD).
    - `attribution` string: The attribution the source's licence requires, on sources that require one.
  - `note` string
  - `summary` string[]

## Other responses

- `400`: The request is not valid: an unknown parameter or an argument the source refuses.
- `404`: No such source or record.
- `429`: Rate limited; retry after the Retry-After header.
- `503`: The source cannot answer from Assyro's copy right now.

---

[API](https://skmtc.dev/assyro/apis/assyro-public-data-api.md) - [All operations](https://skmtc.dev/assyro/apis/assyro-public-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/assyro/apis/assyro-public-data-api/revisions/c861290c9f47?raw)