{
  "data": {
    "id": "gNLP8NNfBg1pGLTii",
    "actId": "GkghjUOmTkxEnZXzw",
    "userId": "NL4ThgItAwaoBlffQ",
    "startedAt": "2026-11-20T07:45:11.038Z",
    "finishedAt": "2026-11-20T07:45:14.111Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 2992,
      "runTimeSecs": 2.992,
      "computeUnits": 0.0033244444444444445,
      "imageSizeBytes": 310791680
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "6GwdnIcc2aWR7LzCS",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Corporations Canada Registry Scraper Input\",\n  \"description\": \"Search Corporations Canada by corporate name, or fetch exact records by corporation number, business number (BN), or internal corporation ID.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byCorporationNumber\",\n        \"byBusinessNumber\",\n        \"byCorporationId\"\n      ],\n      \"enumTitles\": [\n        \"Search by corporate name\",\n        \"Lookup by corporation number\",\n        \"Lookup by business number (BN)\",\n        \"Lookup by corporation ID\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"corpName\": {\n      \"title\": \"Corporate name (mode=search)\",\n      \"type\": \"string\",\n      \"description\": \"Free-text corporate name search, e.g. `Shopify`. Matches whole or partial legal names on Corporations Canada.\",\n      \"editor\": \"textfield\",\n      \"default\": \"Shopify\",\n      \"prefill\": \"Shopify\"\n    },\n    \"corpProvince\": {\n      \"title\": \"Province of registered office (mode=search)\",\n      \"type\": \"string\",\n      \"description\": \"Restrict search results to corporations whose registered office is in this province/territory.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"AB\",\n        \"BC\",\n        \"MB\",\n        \"NB\",\n        \"NF\",\n        \"NT\",\n        \"NS\",\n        \"NU\",\n        \"ON\",\n        \"PE\",\n        \"QC\",\n        \"SK\",\n        \"YT\"\n      ],\n      \"enumTitles\": [\n        \"Any province\",\n        \"Alberta\",\n        \"British Columbia\",\n        \"Manitoba\",\n        \"New Brunswick\",\n        \"Newfoundland and Labrador\",\n        \"Northwest Territories\",\n        \"Nova Scotia\",\n        \"Nunavut\",\n        \"Ontario\",\n        \"Prince Edward Island\",\n        \"Quebec\",\n        \"Saskatchewan\",\n        \"Yukon Territory\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"corpStatus\": {\n      \"title\": \"Corporation status (mode=search)\",\n      \"type\": \"string\",\n      \"description\": \"Restrict search results to corporations with this status.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"1\",\n        \"9\",\n        \"10\",\n        \"11\"\n      ],\n      \"enumTitles\": [\n        \"Any status\",\n        \"Active\",\n        \"Inactive - Amalgamated\",\n        \"Inactive - Discontinued\",\n        \"Dissolved\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"corpAct\": {\n      \"title\": \"Governing legislation / act (mode=search)\",\n      \"type\": \"string\",\n      \"description\": \"Restrict search results to corporations incorporated under this federal act.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"6\",\n        \"14\",\n        \"3\",\n        \"9\",\n        \"7\",\n        \"8\",\n        \"12\",\n        \"5\",\n        \"13\"\n      ],\n      \"enumTitles\": [\n        \"Any act\",\n        \"Canada Business Corporations Act\",\n        \"Canada Not-for-profit Corporations Act\",\n        \"Canada Corporations Act - Part II\",\n        \"Special Act of Parliament\",\n        \"Boards of Trade Act - Part I\",\n        \"Boards of Trade Act - Part II\",\n        \"Canada Cooperatives Act\",\n        \"Pension Fund Societies Act\",\n        \"Other\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"corpNumbers\": {\n      \"title\": \"Corporation numbers (mode=byCorporationNumber)\",\n      \"type\": \"array\",\n      \"description\": \"Exact corporation numbers to look up, e.g. `426160-7`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"businessNumbers\": {\n      \"title\": \"Business numbers / BN (mode=byBusinessNumber)\",\n      \"type\": \"array\",\n      \"description\": \"Exact CRA business numbers to look up, e.g. `847871746` (with or without the `RC0001` program-account suffix).\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"corporationIds\": {\n      \"title\": \"Corporation IDs (mode=byCorporationId)\",\n      \"type\": \"array\",\n      \"description\": \"Internal Corporations Canada `corpId` values to fetch directly, e.g. `4261607`. Get these from a prior search result's `corpId` field or from a bookmarked `fdrlCrpDtls.html?corpId=...` URL.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"includeFullDetails\": {\n      \"title\": \"Include full details\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch the full corporation detail page for every match (registered office address, directors, individuals with significant control, annual filings, corporate name history). When off, only the fast list-level fields are returned (name, numbers, status).\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records.\",\n      \"minimum\": 1,\n      \"maximum\": 200,\n      \"default\": 20,\n      \"prefill\": 3\n    },\n    \"maxPages\": {\n      \"title\": \"Max search pages\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum result pages fetched per search/lookup query (20 results per page). The actor stops early when the registry runs out of results or `maxItems` is reached.\",\n      \"minimum\": 1,\n      \"maximum\": 50,\n      \"default\": 20,\n      \"prefill\": 1\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Corporations Canada Registry Scraper\n\nLook up federally incorporated Canadian companies directly from **Corporations Canada** (ised-isde.canada.ca), the official federal corporate registry operated by Innovation, Science and Economic Development Canada (ISED). Search by corporate name, or fetch an exact record by corporation number, CRA business number (BN), or internal corporation ID — and get back the full public filing: registered office address, directors, individuals with significant control, annual filing history, corporate name history, and the full certificate/filing history.\n\nThis is the same database used to confirm whether a company is a legitimate federally incorporated Canadian corporation, verify its current legal name and status, or find its officers and registered address for due diligence, KYC, sales prospecting, or compliance research.\n\n## What this actor does\n\n- **Four lookup modes:**\n  - `search` — free-text corporate name search with optional province, status, and governing-act filters\n  - `byCorporationNumber` — exact lookup by federal corporation number (e.g. `426160-7`)\n  - `byBusinessNumber` — exact lookup by CRA business number / BN (e.g. `847871746`)\n  - `byCorporationId` — direct fetch using the registry's internal corporation ID\n- **Full public filing per corporation:** legal name, corporation number, business number, status, governing legislation, registered office address, directors, individuals with significant control (or exemption reason), annual filing history, corporate name history, and every certificate/filing on record (incorporation, amendments, restated articles, revival, proxy circulars, financial statements)\n- **Filters:** province/territory of registered office, corporation status (active/dissolved/etc.), governing federal act\n- **Pagination:** configurable `maxPages` plus a hard `maxItems` cap, with deduplication by corporation ID\n- **No login, no cookies, no paid proxy** — reads Corporations Canada's public search pages directly\n- **Empty fields are omitted** — every record only contains data the registry actually published for that corporation\n\n## Output per corporation\n\n| Field | Description |\n|---|---|\n| `corpId` | Corporations Canada's internal corporation ID |\n| `corpName` | Current legal name |\n| `corpNumber` | Federal corporation number (e.g. `426160-7`) |\n| `businessNumber` | CRA business number, including program-account suffix if on file (e.g. `847871746RC0001`) |\n| `status` | Current status text (e.g. `Active`, `Dissolved for non-compliance (s. 212) on 2009-04-17`) |\n| `statusDate` | Date associated with the status, when the registry publishes one (dissolution/discontinuance date) |\n| `statusCategory` | Normalised status bucket: `Active`, `Inactive - Amalgamated`, `Inactive - Discontinued`, or `Dissolved` |\n| `isActive` | `true` only when the current status is active |\n| `governingLegislation` | Federal act the corporation is incorporated under |\n| `governingLegislationDate` | Date the corporation came under that act (incorporation, continuance, or amalgamation date) |\n| `registeredOfficeAddress` | Full registered office address as filed |\n| `registeredOfficeProvince` | Two-letter province/territory code parsed from the address |\n| `registeredOfficeProvinceName` | Full province/territory name for the parsed code |\n| `registeredOfficePostalCode` | Postal code parsed from the address |\n| `directorsMin` / `directorsMax` | Minimum/maximum number of directors permitted per the articles |\n| `directors[]` | Current directors on file — `name`, `address` |\n| `directorCount` | Number of current directors in `directors[]` |\n| `iscExemptionReason` | Why the corporation is exempt from disclosing individuals with significant control (public companies, wholly-owned subsidiaries, etc.) — present instead of `iscIndividuals` when an exemption applies |\n| `iscIndividuals[]` | Individuals with significant control on file — `name`, `address`, `typeOfInterest`, `startDate` |\n| `iscLastUpdated` | Date the ISC information was last updated or confirmed |\n| `anniversaryDate` | Corporation's anniversary date (MM-DD) — the annual-filing trigger date |\n| `lastAnnualMeetingDate` | Date of the last annual meeting on file |\n| `annualFilingPeriodStart` / `annualFilingPeriodEnd` | The 60-day annual-filing window (MM-DD) |\n| `corporationType` | e.g. `Distributing corporation`, `Non-Soliciting`, when published |\n| `annualFilings[]` | Filing status per year — `year`, `status` (e.g. `Filed`, `Not due`, `Overdue`) |\n| `corporateNameHistory[]` | Every legal name the corporation has held — `name`, `fromDate`, `toDate` (omitted for the current name) |\n| `filingHistory[]` | Every certificate/filing on record — `type` (e.g. `Certificate of Incorporation`, `Certificate of Amendment`, `Certificate of Restated Articles of Incorporation`, `Certificate of Revival`, `Proxy circular`, `Financial statements`), `date`, and `details` (e.g. `Amendment details: Corporate name`, `As of 2026-04-21`) when published |\n| `extraProvincialRegistrationUrl` | Link to check the corporation's provincial/territorial extra-provincial registrations on Canada's Business Registries |\n| `sourceUrl` | Canonical Corporations Canada detail page for this record |\n| `scrapedAt` | UTC timestamp of when the record was scraped |\n| `recordType` | Always `corporation` |\n\nWith `includeFullDetails: false`, only `corpId`, `corpName`, `corpNumber`, `businessNumber`, `status`, `sourceUrl`, `recordType`, and `scrapedAt` are returned — every other field above comes from the detail page and requires `includeFullDetails: true` (the default). Within a full-detail record, field availability also depends on what the corporation has on file and its governing act — e.g. not-for-profit corporations don't have an individuals-with-significant-control section, and older/dissolved corporations may be missing some filing details.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `search` | `search` / `byCorporationNumber` / `byBusinessNumber` / `byCorporationId` |\n| `corpName` | string | `Shopify` | Free-text corporate name search (mode=search) |\n| `corpProvince` | select | Any | Restrict to a province/territory of registered office (mode=search) |\n| `corpStatus` | select | Any | Restrict to `Active` / `Inactive - Amalgamated` / `Inactive - Discontinued` / `Dissolved` (mode=search) |\n| `corpAct` | select | Any | Restrict to a governing federal act (mode=search) |\n| `corpNumbers` | array | – | Exact corporation numbers, e.g. `426160-7` (mode=byCorporationNumber) |\n| `businessNumbers` | array | – | Exact CRA business numbers, e.g. `847871746` (mode=byBusinessNumber) |\n| `corporationIds` | array | – | Internal corporation IDs, e.g. `4261607` (mode=byCorporationId) |\n| `includeFullDetails` | boolean | `true` | Fetch the full detail page per match. Turn off for a fast name/number/status-only listing |\n| `maxItems` | integer | `20` | Hard cap on emitted records (1–200) |\n| `maxPages` | integer | `20` | Maximum result pages per search/lookup query (1–50; 20 results per page) |\n\n### Example: search by name with filters\n\n```json\n{\n  \"mode\": \"search\",\n  \"corpName\": \"Bank\",\n  \"corpProvince\": \"ON\",\n  \"corpStatus\": \"1\",\n  \"corpAct\": \"6\",\n  \"maxItems\": 50\n}\n```\n\n### Example: exact lookup by corporation number\n\n```json\n{\n  \"mode\": \"byCorporationNumber\",\n  \"corpNumbers\": [\"426160-7\"]\n}\n```\n\n### Example: exact lookup by business number (BN)\n\n```json\n{\n  \"mode\": \"byBusinessNumber\",\n  \"businessNumbers\": [\"847871746\"]\n}\n```\n\n### Example: direct fetch by corporation ID\n\n```json\n{\n  \"mode\": \"byCorporationId\",\n  \"corporationIds\": [\"4261607\"]\n}\n```\n\n### Example: paginated filtered search\n\n```json\n{\n  \"mode\": \"search\",\n  \"corpName\": \"Bank\",\n  \"corpProvince\": \"ON\",\n  \"corpStatus\": \"1\",\n  \"includeFullDetails\": false,\n  \"maxItems\": 40,\n  \"maxPages\": 2\n}\n```\n\n`maxItems` and `maxPages` both apply: the actor stops at whichever limit is reached first. A single page returns 20 search rows, so `maxPages: 2` fetches up to 40 candidates. When `maxPages` stops the run before `maxItems`, the log says how many results remain available.\n\n### Legacy input keys\n\nOld saved tasks and integrations are supported without schema changes. The actor maps these in code before validating:\n\n| Legacy key | Maps to |\n|---|---|\n| `query`, `keyword`, `searchTerm`, `searchTerms`, `companyName`, `corporateName` | `corpName` |\n| `province`, `provinceCode`, `registeredOfficeProvince` | `corpProvince` |\n| `status`, `statusCode`, `corporationStatus` | `corpStatus` |\n| `act`, `governingAct`, `governingLegislation`, `legislation` | `corpAct` |\n| `corpNumber`, `corporationNumber`, `federalCorporationNumber` | `corpNumbers` (and mode `byCorporationNumber`) |\n| `businessNumber`, `bn`, `craBusinessNumber`, `businessNo` | `businessNumbers` (and mode `byBusinessNumber`) |\n| `corporationId`, `corpId`, `internalCorporationId` | `corporationIds` (and mode `byCorporationId`) |\n| `fullDetails`, `includeDetails`, `detailedItems`, `enrichDetails`, `fetchDetails` | `includeFullDetails` |\n| `maxResults`, `maxRecords`, `maxCompanies`, `limit`, `max` | `maxItems` |\n| `pages`, `pageLimit`, `maxPage` | `maxPages` |\n\nMode aliases such as `name`, `byName`, `byNumber`, `byBN`, `byCorpId`, and `byId` are also accepted. Legacy values win only when the matching visible field is absent or still at its schema default, so a newer task never overrides its own explicit values.\n\n## Use cases\n\n- **KYC / AML due diligence** — confirm a counterparty is a genuine federally incorporated Canadian corporation and check its current status\n- **Sales & lead research** — pull directors and registered addresses for federally incorporated prospects\n- **Compliance monitoring** — track annual-filing status and corporate name changes over time\n- **Corporate research & journalism** — trace a company's incorporation history, name changes, and ownership disclosures\n- **Legal & M&A due diligence** — verify governing legislation, incorporation date, and director records before a transaction\n- **Data enrichment** — attach official registry data (corporation number, BN, status) to an existing company database\n\n## FAQ\n\n**What is Corporations Canada?** The federal corporate registry operated by Innovation, Science and Economic Development Canada (ISED) for corporations incorporated under federal acts such as the *Canada Business Corporations Act* and the *Canada Not-for-profit Corporations Act*.\n\n**Does this cover provincially incorporated companies?** No. Corporations Canada's database only covers corporations created under **federal** law. Companies incorporated provincially (most small businesses) or under financial-institution legislation aren't included — check the relevant provincial/territorial registry or [Canada's Business Registries](https://canadasbusinessregistries.ca/) instead.\n\n**What's the difference between a corporation number and a business number (BN)?** The corporation number (e.g. `426160-7`) is assigned by Corporations Canada at incorporation. The business number (BN) is the 9-digit CRA tax identifier, often shown with a program-account suffix like `RC0001` for a GST/HST account. Either can be used to look up the same corporation.\n\n**Why do some records have `iscExemptionReason` instead of `iscIndividuals`?** Corporations Canada exempts certain corporations — for example public companies listed on a designated stock exchange, or their wholly-owned subsidiaries — from disclosing individuals with significant control. The exemption reason is published in place of the individual-level data.\n\n**Why don't dissolved corporations have director or filing details?** Once a corporation is dissolved, Corporations Canada may retain only partial historical data. The actor returns whatever the registry currently publishes for that record — it never fabricates missing fields.\n\n**How current is this data?** Corporations Canada updates its public records within hours of a filed transaction, and the actor reads the live registry on every run — there's no caching delay.\n\n**Can I search corporations outside a specific province?** Yes — leave `corpProvince` on \"Any\" to search nationwide, or restrict results to a single province/territory of registered office.\n\n**Is a proxy or login required?** No. Corporations Canada's search and detail pages are fully public; the actor doesn't use cookies, an API key, or a paid proxy.\n\n**Is this affiliated with Corporations Canada or the Government of Canada?** No, this is a third-party actor using the public Corporations Canada search and detail pages. It is not affiliated with, endorsed by, or operated by Innovation, Science and Economic Development Canada (ISED) or the Government of Canada.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "corporations-canada-registry-scraper",
      "title": "Corporations Canada Registry Scraper",
      "description": "Look up federally incorporated Canadian companies on Corporations Canada (ised-isde.canada.ca). Search by corporate name with province/status/act filters, or fetch exact records by corporation number, business number (BN), or internal corporation ID.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# Corporations Canada Registry Scraper\n\nLook up federally incorporated Canadian companies directly from **Corporations Canada** (ised-isde.canada.ca), the official federal corporate registry operated by Innovation, Science and Economic Development Canada (ISED). Search by corporate name, or fetch an exact record by corporation number, CRA business number (BN), or internal corporation ID — and get back the full public filing: registered office address, directors, individuals with significant control, annual filing history, corporate name history, and the full certificate/filing history.\n\nThis is the same database used to confirm whether a company is a legitimate federally incorporated Canadian corporation, verify its current legal name and status, or find its officers and registered address for due diligence, KYC, sales prospecting, or compliance research.\n\n## What this actor does\n\n- **Four lookup modes:**\n  - `search` — free-text corporate name search with optional province, status, and governing-act filters\n  - `byCorporationNumber` — exact lookup by federal corporation number (e.g. `426160-7`)\n  - `byBusinessNumber` — exact lookup by CRA business number / BN (e.g. `847871746`)\n  - `byCorporationId` — direct fetch using the registry's internal corporation ID\n- **Full public filing per corporation:** legal name, corporation number, business number, status, governing legislation, registered office address, directors, individuals with significant control (or exemption reason), annual filing history, corporate name history, and every certificate/filing on record (incorporation, amendments, restated articles, revival, proxy circulars, financial statements)\n- **Filters:** province/territory of registered office, corporation status (active/dissolved/etc.), governing federal act\n- **Pagination:** configurable `maxPages` plus a hard `maxItems` cap, with deduplication by corporation ID\n- **No login, no cookies, no paid proxy** — reads Corporations Canada's public search pages directly\n- **Empty fields are omitted** — every record only contains data the registry actually published for that corporation\n\n## Output per corporation\n\n| Field | Description |\n|---|---|\n| `corpId` | Corporations Canada's internal corporation ID |\n| `corpName` | Current legal name |\n| `corpNumber` | Federal corporation number (e.g. `426160-7`) |\n| `businessNumber` | CRA business number, including program-account suffix if on file (e.g. `847871746RC0001`) |\n| `status` | Current status text (e.g. `Active`, `Dissolved for non-compliance (s. 212) on 2009-04-17`) |\n| `statusDate` | Date associated with the status, when the registry publishes one (dissolution/discontinuance date) |\n| `statusCategory` | Normalised status bucket: `Active`, `Inactive - Amalgamated`, `Inactive - Discontinued`, or `Dissolved` |\n| `isActive` | `true` only when the current status is active |\n| `governingLegislation` | Federal act the corporation is incorporated under |\n| `governingLegislationDate` | Date the corporation came under that act (incorporation, continuance, or amalgamation date) |\n| `registeredOfficeAddress` | Full registered office address as filed |\n| `registeredOfficeProvince` | Two-letter province/territory code parsed from the address |\n| `registeredOfficeProvinceName` | Full province/territory name for the parsed code |\n| `registeredOfficePostalCode` | Postal code parsed from the address |\n| `directorsMin` / `directorsMax` | Minimum/maximum number of directors permitted per the articles |\n| `directors[]` | Current directors on file — `name`, `address` |\n| `directorCount` | Number of current directors in `directors[]` |\n| `iscExemptionReason` | Why the corporation is exempt from disclosing individuals with significant control (public companies, wholly-owned subsidiaries, etc.) — present instead of `iscIndividuals` when an exemption applies |\n| `iscIndividuals[]` | Individuals with significant control on file — `name`, `address`, `typeOfInterest`, `startDate` |\n| `iscLastUpdated` | Date the ISC information was last updated or confirmed |\n| `anniversaryDate` | Corporation's anniversary date (MM-DD) — the annual-filing trigger date |\n| `lastAnnualMeetingDate` | Date of the last annual meeting on file |\n| `annualFilingPeriodStart` / `annualFilingPeriodEnd` | The 60-day annual-filing window (MM-DD) |\n| `corporationType` | e.g. `Distributing corporation`, `Non-Soliciting`, when published |\n| `annualFilings[]` | Filing status per year — `year`, `status` (e.g. `Filed`, `Not due`, `Overdue`) |\n| `corporateNameHistory[]` | Every legal name the corporation has held — `name`, `fromDate`, `toDate` (omitted for the current name) |\n| `filingHistory[]` | Every certificate/filing on record — `type` (e.g. `Certificate of Incorporation`, `Certificate of Amendment`, `Certificate of Restated Articles of Incorporation`, `Certificate of Revival`, `Proxy circular`, `Financial statements`), `date`, and `details` (e.g. `Amendment details: Corporate name`, `As of 2026-04-21`) when published |\n| `extraProvincialRegistrationUrl` | Link to check the corporation's provincial/territorial extra-provincial registrations on Canada's Business Registries |\n| `sourceUrl` | Canonical Corporations Canada detail page for this record |\n| `scrapedAt` | UTC timestamp of when the record was scraped |\n| `recordType` | Always `corporation` |\n\nWith `includeFullDetails: false`, only `corpId`, `corpName`, `corpNumber`, `businessNumber`, `status`, `sourceUrl`, `recordType`, and `scrapedAt` are returned — every other field above comes from the detail page and requires `includeFullDetails: true` (the default). Within a full-detail record, field availability also depends on what the corporation has on file and its governing act — e.g. not-for-profit corporations don't have an individuals-with-significant-control section, and older/dissolved corporations may be missing some filing details.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `search` | `search` / `byCorporationNumber` / `byBusinessNumber` / `byCorporationId` |\n| `corpName` | string | `Shopify` | Free-text corporate name search (mode=search) |\n| `corpProvince` | select | Any | Restrict to a province/territory of registered office (mode=search) |\n| `corpStatus` | select | Any | Restrict to `Active` / `Inactive - Amalgamated` / `Inactive - Discontinued` / `Dissolved` (mode=search) |\n| `corpAct` | select | Any | Restrict to a governing federal act (mode=search) |\n| `corpNumbers` | array | – | Exact corporation numbers, e.g. `426160-7` (mode=byCorporationNumber) |\n| `businessNumbers` | array | – | Exact CRA business numbers, e.g. `847871746` (mode=byBusinessNumber) |\n| `corporationIds` | array | – | Internal corporation IDs, e.g. `4261607` (mode=byCorporationId) |\n| `includeFullDetails` | boolean | `true` | Fetch the full detail page per match. Turn off for a fast name/number/status-only listing |\n| `maxItems` | integer | `20` | Hard cap on emitted records (1–200) |\n| `maxPages` | integer | `20` | Maximum result pages per search/lookup query (1–50; 20 results per page) |\n\n### Example: search by name with filters\n\n```json\n{\n  \"mode\": \"search\",\n  \"corpName\": \"Bank\",\n  \"corpProvince\": \"ON\",\n  \"corpStatus\": \"1\",\n  \"corpAct\": \"6\",\n  \"maxItems\": 50\n}\n```\n\n### Example: exact lookup by corporation number\n\n```json\n{\n  \"mode\": \"byCorporationNumber\",\n  \"corpNumbers\": [\"426160-7\"]\n}\n```\n\n### Example: exact lookup by business number (BN)\n\n```json\n{\n  \"mode\": \"byBusinessNumber\",\n  \"businessNumbers\": [\"847871746\"]\n}\n```\n\n### Example: direct fetch by corporation ID\n\n```json\n{\n  \"mode\": \"byCorporationId\",\n  \"corporationIds\": [\"4261607\"]\n}\n```\n\n### Example: paginated filtered search\n\n```json\n{\n  \"mode\": \"search\",\n  \"corpName\": \"Bank\",\n  \"corpProvince\": \"ON\",\n  \"corpStatus\": \"1\",\n  \"includeFullDetails\": false,\n  \"maxItems\": 40,\n  \"maxPages\": 2\n}\n```\n\n`maxItems` and `maxPages` both apply: the actor stops at whichever limit is reached first. A single page returns 20 search rows, so `maxPages: 2` fetches up to 40 candidates. When `maxPages` stops the run before `maxItems`, the log says how many results remain available.\n\n### Legacy input keys\n\nOld saved tasks and integrations are supported without schema changes. The actor maps these in code before validating:\n\n| Legacy key | Maps to |\n|---|---|\n| `query`, `keyword`, `searchTerm`, `searchTerms`, `companyName`, `corporateName` | `corpName` |\n| `province`, `provinceCode`, `registeredOfficeProvince` | `corpProvince` |\n| `status`, `statusCode`, `corporationStatus` | `corpStatus` |\n| `act`, `governingAct`, `governingLegislation`, `legislation` | `corpAct` |\n| `corpNumber`, `corporationNumber`, `federalCorporationNumber` | `corpNumbers` (and mode `byCorporationNumber`) |\n| `businessNumber`, `bn`, `craBusinessNumber`, `businessNo` | `businessNumbers` (and mode `byBusinessNumber`) |\n| `corporationId`, `corpId`, `internalCorporationId` | `corporationIds` (and mode `byCorporationId`) |\n| `fullDetails`, `includeDetails`, `detailedItems`, `enrichDetails`, `fetchDetails` | `includeFullDetails` |\n| `maxResults`, `maxRecords`, `maxCompanies`, `limit`, `max` | `maxItems` |\n| `pages`, `pageLimit`, `maxPage` | `maxPages` |\n\nMode aliases such as `name`, `byName`, `byNumber`, `byBN`, `byCorpId`, and `byId` are also accepted. Legacy values win only when the matching visible field is absent or still at its schema default, so a newer task never overrides its own explicit values.\n\n## Use cases\n\n- **KYC / AML due diligence** — confirm a counterparty is a genuine federally incorporated Canadian corporation and check its current status\n- **Sales & lead research** — pull directors and registered addresses for federally incorporated prospects\n- **Compliance monitoring** — track annual-filing status and corporate name changes over time\n- **Corporate research & journalism** — trace a company's incorporation history, name changes, and ownership disclosures\n- **Legal & M&A due diligence** — verify governing legislation, incorporation date, and director records before a transaction\n- **Data enrichment** — attach official registry data (corporation number, BN, status) to an existing company database\n\n## FAQ\n\n**What is Corporations Canada?** The federal corporate registry operated by Innovation, Science and Economic Development Canada (ISED) for corporations incorporated under federal acts such as the *Canada Business Corporations Act* and the *Canada Not-for-profit Corporations Act*.\n\n**Does this cover provincially incorporated companies?** No. Corporations Canada's database only covers corporations created under **federal** law. Companies incorporated provincially (most small businesses) or under financial-institution legislation aren't included — check the relevant provincial/territorial registry or [Canada's Business Registries](https://canadasbusinessregistries.ca/) instead.\n\n**What's the difference between a corporation number and a business number (BN)?** The corporation number (e.g. `426160-7`) is assigned by Corporations Canada at incorporation. The business number (BN) is the 9-digit CRA tax identifier, often shown with a program-account suffix like `RC0001` for a GST/HST account. Either can be used to look up the same corporation.\n\n**Why do some records have `iscExemptionReason` instead of `iscIndividuals`?** Corporations Canada exempts certain corporations — for example public companies listed on a designated stock exchange, or their wholly-owned subsidiaries — from disclosing individuals with significant control. The exemption reason is published in place of the individual-level data.\n\n**Why don't dissolved corporations have director or filing details?** Once a corporation is dissolved, Corporations Canada may retain only partial historical data. The actor returns whatever the registry currently publishes for that record — it never fabricates missing fields.\n\n**How current is this data?** Corporations Canada updates its public records within hours of a filed transaction, and the actor reads the live registry on every run — there's no caching delay.\n\n**Can I search corporations outside a specific province?** Yes — leave `corpProvince` on \"Any\" to search nationwide, or restrict results to a single province/territory of registered office.\n\n**Is a proxy or login required?** No. Corporations Canada's search and detail pages are fully public; the actor doesn't use cookies, an API key, or a paid proxy.\n\n**Is this affiliated with Corporations Canada or the Government of Canada?** No, this is a third-party actor using the public Corporations Canada search and detail pages. It is not affiliated with, endorsed by, or operated by Innovation, Science and Economic Development Canada (ISED) or the Government of Canada.\n",
      "input": {
        "title": "Corporations Canada Registry Scraper Input",
        "description": "Search Corporations Canada by corporate name, or fetch exact records by corporation number, business number (BN), or internal corporation ID.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch.",
            "editor": "select",
            "enum": [
              "search",
              "byCorporationNumber",
              "byBusinessNumber",
              "byCorporationId"
            ],
            "enumTitles": [
              "Search by corporate name",
              "Lookup by corporation number",
              "Lookup by business number (BN)",
              "Lookup by corporation ID"
            ],
            "default": "search",
            "prefill": "search"
          },
          "corpName": {
            "title": "Corporate name (mode=search)",
            "type": "string",
            "description": "Free-text corporate name search, e.g. `Shopify`. Matches whole or partial legal names on Corporations Canada.",
            "editor": "textfield",
            "default": "Shopify",
            "prefill": "Shopify"
          },
          "corpProvince": {
            "title": "Province of registered office (mode=search)",
            "type": "string",
            "description": "Restrict search results to corporations whose registered office is in this province/territory.",
            "editor": "select",
            "enum": [
              "",
              "AB",
              "BC",
              "MB",
              "NB",
              "NF",
              "NT",
              "NS",
              "NU",
              "ON",
              "PE",
              "QC",
              "SK",
              "YT"
            ],
            "enumTitles": [
              "Any province",
              "Alberta",
              "British Columbia",
              "Manitoba",
              "New Brunswick",
              "Newfoundland and Labrador",
              "Northwest Territories",
              "Nova Scotia",
              "Nunavut",
              "Ontario",
              "Prince Edward Island",
              "Quebec",
              "Saskatchewan",
              "Yukon Territory"
            ],
            "default": "",
            "prefill": ""
          },
          "corpStatus": {
            "title": "Corporation status (mode=search)",
            "type": "string",
            "description": "Restrict search results to corporations with this status.",
            "editor": "select",
            "enum": [
              "",
              "1",
              "9",
              "10",
              "11"
            ],
            "enumTitles": [
              "Any status",
              "Active",
              "Inactive - Amalgamated",
              "Inactive - Discontinued",
              "Dissolved"
            ],
            "default": "",
            "prefill": ""
          },
          "corpAct": {
            "title": "Governing legislation / act (mode=search)",
            "type": "string",
            "description": "Restrict search results to corporations incorporated under this federal act.",
            "editor": "select",
            "enum": [
              "",
              "6",
              "14",
              "3",
              "9",
              "7",
              "8",
              "12",
              "5",
              "13"
            ],
            "enumTitles": [
              "Any act",
              "Canada Business Corporations Act",
              "Canada Not-for-profit Corporations Act",
              "Canada Corporations Act - Part II",
              "Special Act of Parliament",
              "Boards of Trade Act - Part I",
              "Boards of Trade Act - Part II",
              "Canada Cooperatives Act",
              "Pension Fund Societies Act",
              "Other"
            ],
            "default": "",
            "prefill": ""
          },
          "corpNumbers": {
            "title": "Corporation numbers (mode=byCorporationNumber)",
            "type": "array",
            "description": "Exact corporation numbers to look up, e.g. `426160-7`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "businessNumbers": {
            "title": "Business numbers / BN (mode=byBusinessNumber)",
            "type": "array",
            "description": "Exact CRA business numbers to look up, e.g. `847871746` (with or without the `RC0001` program-account suffix).",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "corporationIds": {
            "title": "Corporation IDs (mode=byCorporationId)",
            "type": "array",
            "description": "Internal Corporations Canada `corpId` values to fetch directly, e.g. `4261607`. Get these from a prior search result's `corpId` field or from a bookmarked `fdrlCrpDtls.html?corpId=...` URL.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "includeFullDetails": {
            "title": "Include full details",
            "type": "boolean",
            "description": "Fetch the full corporation detail page for every match (registered office address, directors, individuals with significant control, annual filings, corporate name history). When off, only the fast list-level fields are returned (name, numbers, status).",
            "default": true,
            "prefill": true
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "minimum": 1,
            "maximum": 200,
            "default": 20,
            "prefill": 3
          },
          "maxPages": {
            "title": "Max search pages",
            "type": "integer",
            "description": "Maximum result pages fetched per search/lookup query (20 results per page). The actor stops early when the registry runs out of results or `maxItems` is reached.",
            "minimum": 1,
            "maximum": 50,
            "default": 20,
            "prefill": 1
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Corporations Canada Registry Scraper Output",
        "description": "Federal corporation records from Corporations Canada — legal name, corporation/business numbers, status, governing legislation, registered office, directors, individuals with significant control, annual filings, corporate name history, and certificate/filing history.",
        "properties": {
          "corporations": {
            "type": "string",
            "title": "Corporations Canada records",
            "description": "Dataset containing all scraped Corporations Canada records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Corporations",
              "transformation": {
                "fields": [
                  "corpName",
                  "corpNumber",
                  "businessNumber",
                  "status",
                  "statusCategory",
                  "isActive",
                  "governingLegislation",
                  "registeredOfficeProvince",
                  "registeredOfficeProvinceName",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "2286355e502d38e88fcf16524e3b446bd23e97b560e2890c9c6b1bc1b7af4103",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0033244444444444445
    }
  }
}