What’s covered
Every key below is always present on theregulatory object as a flat array. An empty array means no matches — not an error.
The registries below are worked through in detail because they’re the ones most often used for compliance checks. Every other key returns the same shape — see Common fields.
Enabling the search
WhenregulatoryRegistry is omitted, it follows your account’s configured search settings. Pass it explicitly to override that for a single search — for example, to disable it when you only need corporate registry results:
Registered Charities
Searches the CRA’s list of registered charities and other qualified donees. Useful for: verifying charitable status before processing donations or grants, confirming a non-profit’s registration number.registrationNumber for charities follows the CRA Business Number format: 9-digit BN + RR + 4-digit account (e.g. 123456789RR0001).
Money Services Businesses
Searches FINTRAC’s public registry of registered Money Services Businesses. MSBs are legally required to register with FINTRAC if they deal in foreign exchange, money transfers, virtual currencies, cheque cashing, or prepaid payment products. Useful for: KYB/AML compliance checks before onboarding a financial services company, verifying a crypto exchange or remittance provider’s registration status.M followed by 8 digits. Status values include Active and Expired.
MSBs often operate under trade names that differ from their legal name. Check
alternateNames when the legal name match score is low — the same entity may
be registered under a different name.Cannabis Retail — AGCO (Ontario)
Searches the AGCO’s registry of licensed cannabis retail stores in Ontario. Useful for: verifying a cannabis retailer holds a valid Ontario licence before entering a commercial relationship or lease agreement.Liquor Licences — AGCO (Ontario)
The AGCO publishes three separate liquor licensing registries, and each has its own key. They are not nested under a singleagco key, and a business can
appear in more than one of them.
Useful for: confirming an Ontario hospitality, retail or beverage business
holds a current liquor licence for the premises you’re dealing with.
All three return the same
details shape. Any field can be absent when the AGCO
publishes no value for it.
The licensed premises name is returned in
alternateNames, and the premises
address in addresses.
Cannabis Production — Health Canada
Searches Health Canada’s list of licensed cannabis producers, processors, researchers, and distributors under the Cannabis Act. Useful for: verifying a cannabis producer or processor holds a valid federal licence for commercial transactions, investment due diligence. Health Canada publishes no status column for these licences, sostatus is
always null. A licence that is no longer in force is published as a status
phrase in place of its licence types, so derivedStatus still reports the
standing — inactive for a suspended, revoked or expired licence, active
where licence types are listed.
Health Service Providers — Ontario MOH
Searches the Ontario Ministry of Health’s registry of regulated health service provider locations, including pharmacies, laboratories, and other licensed health facilities. Useful for: verifying a healthcare business holds a valid Ontario MOH licence, due diligence on health sector suppliers or partners. This registry publishes no status for its records, sostatus is always null
and derivedStatus is always unknown. A match means the provider appears in
the registry; it is not a statement about standing.
Common fields across all registries
Which status field to use. Branch on
derivedStatus — it means the same
thing everywhere. Show status to a human, but don’t compare it: each
registry publishes its own wording, and that wording can change without any
release on our side.Two things to be careful of. inactive means “not currently in force”, which
includes an application that is still pending or in review — it is not a
claim that anything adverse happened, so read status for that distinction.
And unknown / null mean “no answer”, never a negative finding.Full derivedStatus mapping
Every status label we recognise, and the standing it produces. Labels are
matched case-insensitively and on substrings, so "LAPSED", "Lapsed" and
"Licence lapsed" all resolve the same way.
active — in force
inactive — not in force
unknown — the registry publishes no status for this record.
null — the registry published a label we do not yet classify. Read
status and treat it as unclassified; we add labels as sources introduce them.