{
  "openapi": "3.0.1",
  "info": {
    "title": "Canada New Corporations Feed: Federal Incorporations Daily",
    "description": "Daily feed of newly incorporated Canadian federal corporations from official Corporations Canada open data: CBCA business corporations, not-for-profits and co-operatives with corporation number, BN, city, province and postal FSA. Filter by province, city, name. Entity-level only.",
    "version": "0.2",
    "x-build-id": "G88W2fORU2cSgouf1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/moment-data~canada-new-corporations-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-moment-data-canada-new-corporations-feed",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/moment-data~canada-new-corporations-feed/runs": {
      "post": {
        "operationId": "runs-sync-moment-data-canada-new-corporations-feed",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/moment-data~canada-new-corporations-feed/run-sync": {
      "post": {
        "operationId": "run-sync-moment-data-canada-new-corporations-feed",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "eventType": {
            "title": "Event type",
            "enum": [
              "newCorporation",
              "statusChange",
              "currentStatus"
            ],
            "type": "string",
            "description": "newCorporation = newly incorporated corporations (default, uses Mode / Days back). statusChange = corporations whose status changed since the previous statusChange run with the same State key (the source has no dissolution date, so the first run only saves a baseline snapshot and returns 0 records; schedule it daily). currentStatus = stateless list of active corporations currently flagged Dissolution Pending (non-compliance) or similar.",
            "default": "newCorporation"
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "window",
              "sinceLastRun"
            ],
            "type": "string",
            "description": "window = every matching corporation incorporated in the last Days back days (stateless, default). sinceLastRun = only corporations not delivered by a previous run with the same State key (re-reads the last 14 days because Corporations Canada adds some records a few days late). Applies to eventType newCorporation; statusChange is always since-last-run.",
            "default": "window"
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Incorporation-date window ending on the date of the latest Corporations Canada file (refreshed daily around 11:00 UTC). Roughly 150-300 new federal business corporations are incorporated per working day.",
            "default": 3
          },
          "corporationTypes": {
            "title": "Corporation types",
            "type": "array",
            "description": "business (Canada Business Corporations Act), nonProfit (Canada Not-for-profit Corporations Act), cooperative (Canada Cooperatives Act), boardOfTrade (Boards of Trade Act), other (Special Acts etc.). Empty = all. Only business = smaller download.",
            "items": {
              "type": "string"
            }
          },
          "provinces": {
            "title": "Provinces / territories",
            "type": "array",
            "description": "Registered-office province: 2-letter codes (ON, QC, BC, AB, MB, SK, NS, NB, NL, PE, YT, NT, NU) or names. Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Registered-office city/town, exact match ignoring case and accents (Toronto, Montréal, Vancouver, Calgary). Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "postalCodePrefixes": {
            "title": "Postal code prefixes (FSA)",
            "type": "array",
            "description": "Postal code prefixes, 1-3 characters: M (Toronto), H (Montreal), V6 (Vancouver), T2 (Calgary), K1A. Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "nameKeywords": {
            "title": "Name contains (any)",
            "type": "array",
            "description": "Keep corporations whose name (English or French form) contains any of these words, e.g. tech, construction, holdings, consulting, restaurant.",
            "items": {
              "type": "string"
            }
          },
          "excludeNameKeywords": {
            "title": "Name excludes",
            "type": "array",
            "description": "Drop corporations whose name contains any of these words, e.g. holdings, gestion.",
            "items": {
              "type": "string"
            }
          },
          "excludeNumberedCompanies": {
            "title": "Exclude numbered companies",
            "type": "boolean",
            "description": "Drop numbered companies like '18322741 Canada Inc.' (about 40% of new CBCA incorporations).",
            "default": false
          },
          "onlyWithBusinessNumber": {
            "title": "Only with a Business Number (BN)",
            "type": "boolean",
            "description": "Keep only corporations that already have a CRA Business Number.",
            "default": false
          },
          "onlyNoAnnualReturnYet": {
            "title": "Only corporations with no annual return yet",
            "type": "boolean",
            "description": "Drop records that already filed an annual return (useful with long windows to focus on brand-new incorporations).",
            "default": false
          },
          "changeTypes": {
            "title": "Change types (statusChange)",
            "type": "array",
            "description": "statusChange only. Any of: dissolutionPending, intentToDissolve, discontinuancePending, dissolved, amalgamated, discontinued, revived, backToActive, statusChanged. Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "listStatuses": {
            "title": "Statuses to list (currentStatus)",
            "type": "array",
            "description": "currentStatus only. Any of: dissolutionPending (about 31k corporations), intentToDissolve (~1k), discontinuancePending (~150). Empty = dissolutionPending.",
            "items": {
              "type": "string"
            }
          },
          "autoExtend": {
            "title": "Widen window when it is short",
            "type": "boolean",
            "description": "In window mode, walk back day by day (max 14 days) when fewer than about 25 records match (weekends, holidays, narrow filters). Turn off to get exactly the Days back window.",
            "default": true
          },
          "maxItems": {
            "title": "Max records per run",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Hard cap on delivered records (also caps your spend). newCorporation: newest first in window mode, oldest first in sinceLastRun mode. statusChange: changes over the cap are held and reported by the next run. currentStatus: most recent annual filers first.",
            "default": 30
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "sinceLastRun and statusChange: separate saved state per saved search (e.g. 'toronto-tech'). newCorporation and statusChange states are stored separately.",
            "default": "default"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}