Capvant

Canada

What the Canada market sends on a deal: currency, phone format, company types, validation and the fields that carry a value.

The Canada lane routes deals in CAD with market.country set to CA. Everything below is what your integration can rely on for this market.

At a glance

FieldValue
ISO country codeCA
Launch stateOpen: live requests are accepted
CurrencyCAD (C$)
Phone formatE.164, country code first, no spaces required.
Example phone+1 416 555 0148
Regional subdivisionprovince
Company registerThe federal company register
Register number askedCorporation number or business number (for example 1234567-8)
Company number formatCorporation number, seven digits, for example 1234567.
Credit score bandcollected

Company register

RegisterThe federal company register
registry.sourceofficial_register in every market; which register answered is not part of the payload
Company lookup in the flowBy name, with a dropdown of register matches; the Corporation number is optional and one click away
IdentifierCorporation number: The federal corporation number, or the nine-digit business number, for example 3924181
Name searchYes

What comes back, section by section

Read registry.status first. available means every section the register exposes came back; partial means at least one could not be read; unavailable means the company profile itself could not be retrieved; not_fetched means no lookup has run for this lead yet. A section the register does not expose is null on every deal, never an empty value. Each entry under registry.sections carries the register's status for that section and the facts it returned, nothing else.

SectionAvailabilityNote
IdentityAvailable
Legal formAvailableThe governing act
StatusAvailable
Incorporation dateAvailable
Registered addressAvailableRegistered office
Activity codesNot exposed by the register
OfficersPartialDirectors where the federal record lists them
OwnersNot exposed by the register
AccountsNot exposed by the register
InsolvencyNot exposed by the register
FilingsPartialAnnual filing status and whether it is overdue

Caveats carried on every record:

  • Federally incorporated companies only. A provincially incorporated company, including every company registered solely in Quebec, is not in this register, so a miss is not evidence the company does not exist.

Example registry object

Captured on 2026-09-11 for a federally incorporated Ontario company (identifier 3924181). This is the market.registry object exactly as the API returned it.

market.registry
{
  "source": "official_register",
  "status": "available",
  "incorporated_on": "2001-07-19",
  "company_age_months": 301,
  "company_status": "Inactive - Amalgamated",
  "company_type": "Canada Business Corporations Act",
  "sic_codes": null,
  "registered_office": {
    "line1": "CORUS QUAY",
    "line2": "25 DOCKSIDE DRIVE",
    "locality": "TORONTO",
    "region": "ON",
    "postal_code": "M5A 0B5",
    "country": "CA"
  },
  "directors": null,
  "psc_count": null,
  "accounts": null,
  "confirmation_statement": null,
  "charges_count": null,
  "has_insolvency_history": null,
  "filed_financials": null,
  "registers": null,
  "exemptions": null,
  "uk_establishments_count": null,
  "disqualified_directors_count": null,
  "registered_name": "3924181 CANADA INC.",
  "identifiers": {
    "business_number": "870047412",
    "lei": null
  },
  "activity_codes": null,
  "officers": null,
  "filings": null,
  "share_capital": null,
  "business_description": null,
  "sections": {
    "profile": {
      "status": "available",
      "data": {
        "company_name": "3924181 CANADA INC.",
        "company_status": "Inactive - Amalgamated",
        "type": "Canada Business Corporations Act",
        "date_of_creation": "2001-07-19",
        "registered_office_address": {
          "address_line_1": "CORUS QUAY",
          "address_line_2": "25 DOCKSIDE DRIVE",
          "locality": "TORONTO",
          "region": "ON",
          "postal_code": "M5A 0B5",
          "country": "CA"
        },
        "business_number": "870047412",
        "director_limits": {
          "minimum": 1,
          "maximum": 10
        },
        "annual_returns": [
          {
            "year": "2024",
            "annual_meeting_date": "2024-02-28"
          },
          {
            "year": "2023",
            "annual_meeting_date": "2023-02-28"
          },
          {
            "year": "2022",
            "annual_meeting_date": "2022-02-28"
          }
        ],
        "latest_annual_return_year": 2024,
        "activities": [
          {
            "activity": "Incorporation",
            "date": "2001-07-19"
          },
          {
            "activity": "Amendment",
            "date": "2023-08-22"
          }
        ],
        "directors": null,
        "sic_codes": null,
        "annual_return_overdue": null
      }
    }
  },
  "checked_at": "2026-09-11T14:02:27.561Z"
}

Phone and identifiers

PhoneE.164, country code first, no spaces required. For example +1 416 555 0148.
Company identifierCorporation number: The federal corporation number, or the nine-digit business number, for example 3924181
Tax identifierNot collected in this market
VAT checkNot applicable: no VAT register check in this market, so market.vat is null.

Bank statements

The flow asks for the last 6 months of business bank statements in this market. Statements are uploaded once and shared with every partner working the request; the API carries the parsed facts (months covered, average monthly inflow and outflow, provider) and the documents by signed link.

Instant matching

Instant matching is live: a submitted deal is routed to the panel the moment it arrives, and matched options come back on the same call.

Which market fields are populated

FieldTypeIn CanadaNotes
countrystringpopulatedISO 3166-1 alpha-2, always CA in this schema. The applicant’s own country, which can differ from the routing lane.
currencystringpopulatedISO 4217 code for every figure on the deal.
monthly_revenue_bandstringpopulatedThe band the applicant selected, kept whatever monthly_revenue_basis says.
monthly_revenuenumberpopulatedMonthly figure. The parsed statements’ average monthly inflow once statements are in; before that the applicant’s figure. Read monthly_revenue_basis.
monthly_revenue_basisstringpopulatedstatements: the parsed statements’ average monthly inflow. reported: the applicant gave the figure. band_midpoint: the midpoint of the selected band. Precedence is always statements, then register, then applicant.
time_in_business_bandstringpopulatedThe band the applicant selected, kept whatever tib_months_basis says.
tib_monthsintegerpopulatedMonths in business. From the register’s incorporation date where the register is connected; read tib_months_basis.
tib_months_basisstringpopulatedregister: computed from the incorporation date on the company register. reported: from an exact trading start date the applicant gave. band_midpoint: the midpoint of the selected band. The register wins whenever it holds a date.
annual_turnovernumbernullAnnual figure. The latest filed accounts where the register carries them, else what the applicant stated. Never derived from the monthly figure.
annual_turnover_basisstringnullfiled_accounts: from the latest filed accounts on the register. reported: the applicant stated the figure.
company_numberstringpopulatedRegistration number on the country’s company register. Confirmed against the register where that market answers, otherwise as the applicant gave it; registry.status says which case this deal is in, and in the United States that varies by state.
entity_typestringpopulatedLegal form: the value from GET /enums/company-types for this market. From the applicant where the flow asks, else from the register; entity_type_basis says which.
entity_type_basisstringpopulatedapplicant: the legal form as the applicant gave it. register: read from the company register’s own record where the flow did not ask. Null when neither holds it.
vat_registeredbooleannullWhether the business is VAT registered: from the applicant where the flow asks, else from the VAT check. Null when neither holds it.
vatobjectnullThe check of the VAT number the applicant gave against the national VAT register. Null until a number is given.
identifiersobjectpopulatedThe company’s identifiers in Canada: exactly these keys. A key that is present and null is not on record yet.
registryobjectpopulatedPublic register facts for the company. Read registry.status before the facts.
directorobjectnullThe significant person as the flow captured them. Null until a funder’s question is answered.
credit_score_bandstringpopulatedSelf-reported band, for example "700_plus". Asked where the flow needs it; null when the applicant was not asked.
regionstringpopulatedThe province, from the flow. Never inferred from anything else.
einstringnullEmployer identification number, XX-XXXXXXX, when the applicant gave it. Optional in the flow.
signup_ipstringnullThe applicant’s IP address at the moment of consent, for funders that require it.

Company types

ValueAbbreviationLegal formLocal nameFundable
federal_corporationInc.Federal corporationCorporation (CBCA)yes
provincial_corporationInc.Provincial corporationProvincial corporationyes
partnershipLPPartnershipGeneral or limited partnershipyes
cooperativeCo-opCooperativeCooperativeyes
sole_proprietorshipSole prop.Sole proprietorshipSole proprietorshipaccepted, not fundable

Canada has no connected register yet, so market.entity_type is what the applicant gave and is null on the deal until the register confirms it.

Amount and revenue bands

A band stays a band. Where we derive a number from a band, the payload says so in the matching _basis field, so never treat a derived figure as reported.

fundingLabelDerived value
under_25kUnder C$25Knot derived
25k_50kC$25K – C$50Knot derived
50k_100kC$50K – C$100Knot derived
100k_250kC$100K – C$250Knot derived
250k_500kC$250K – C$500Knot derived
500k_1mC$500K – C$1Mnot derived
1m_2mC$1M – C$2Mnot derived
2m_5mC$2M – C$5Mnot derived
5m_15mC$5M – C$15Mnot derived
15m_50mC$15M – C$50Mnot derived
monthly revenueLabelDerived value
under_10kUnder C$10K5,000 CAD, band midpoint
10k_20kC$10K – C$20K15,000 CAD, band midpoint
20k_50kC$20K – C$50K35,000 CAD, band midpoint
50k_75kC$50K – C$75K62,500 CAD, band midpoint
75k_100kC$75K – C$100K87,500 CAD, band midpoint
100k_250kC$100K – C$250K175,000 CAD, band midpoint
250k_plusC$250K+350,000 CAD, band midpoint
time in businessLabelDerived value
under_6mUnder 6 months3 months, band midpoint
6_12m6 – 12 months9 months, band midpoint
1_2y1 – 2 years18 months, band midpoint
2y_plus2+ years30 months, band midpoint
credit scoreLabelDerived value
below_500Below 500not derived
500_549500 – 549not derived
550_599550 – 599not derived
600_649600 – 649not derived
650_699650 – 699not derived
700_plus700+not derived

Example market object

This is the market object exactly as GET /deals/{ref} returns it for this country.

🇨🇦 Canada, market object
{
  "market": {
    "country": "CA",
    "currency": "CAD",
    "monthly_revenue_band": "C$20K – C$50K",
    "monthly_revenue": 35000,
    "monthly_revenue_basis": "band_midpoint",
    "time_in_business_band": "2+ years",
    "tib_months": 301,
    "tib_months_basis": "register",
    "credit_score_band": "700+",
    "region": "ON",
    "company_number": "3924181",
    "entity_type": "federal_corporation",
    "entity_type_basis": "register",
    "identifiers": {
      "business_number": "870047412"
    },
    "registry": {
      "source": "official_register",
      "status": "available",
      "incorporated_on": "2001-07-19",
      "company_age_months": 301,
      "company_status": "Inactive - Amalgamated",
      "company_type": "Canada Business Corporations Act",
      "sic_codes": null,
      "registered_office": {
        "line1": "CORUS QUAY",
        "line2": "25 DOCKSIDE DRIVE",
        "locality": "TORONTO",
        "region": "ON",
        "postal_code": "M5A 0B5",
        "country": "CA"
      },
      "directors": null,
      "psc_count": null,
      "accounts": null,
      "confirmation_statement": null,
      "charges_count": null,
      "has_insolvency_history": null,
      "filed_financials": null,
      "registers": null,
      "exemptions": null,
      "uk_establishments_count": null,
      "disqualified_directors_count": null,
      "registered_name": "3924181 CANADA INC.",
      "identifiers": {
        "business_number": "870047412",
        "lei": null
      },
      "activity_codes": null,
      "officers": null,
      "filings": null,
      "share_capital": null,
      "business_description": null,
      "sections": {
        "profile": {
          "status": "available",
          "data": {
            "company_name": "3924181 CANADA INC.",
            "company_status": "Inactive - Amalgamated",
            "type": "Canada Business Corporations Act",
            "date_of_creation": "2001-07-19",
            "registered_office_address": {
              "address_line_1": "CORUS QUAY",
              "address_line_2": "25 DOCKSIDE DRIVE",
              "locality": "TORONTO",
              "region": "ON",
              "postal_code": "M5A 0B5",
              "country": "CA"
            },
            "business_number": "870047412",
            "director_limits": {
              "minimum": 1,
              "maximum": 10
            },
            "annual_returns": [
              {
                "year": "2024",
                "annual_meeting_date": "2024-02-28"
              },
              {
                "year": "2023",
                "annual_meeting_date": "2023-02-28"
              },
              {
                "year": "2022",
                "annual_meeting_date": "2022-02-28"
              }
            ],
            "latest_annual_return_year": 2024,
            "activities": [
              {
                "activity": "Incorporation",
                "date": "2001-07-19"
              },
              {
                "activity": "Amendment",
                "date": "2023-08-22"
              }
            ],
            "directors": null,
            "sic_codes": null,
            "annual_return_overdue": null
          }
        }
      },
      "checked_at": "2026-09-11T14:02:27.561Z"
    },
    "director": null
  }
}

Validation to expect

  • market.country is CA, never the routing lane and never an alpha-3 code.
  • Every monetary figure on the deal is in CAD.
  • Phone numbers arrive in E.164, for example +1 416 555 0148.
  • market.company_number carries the register number and market.registry carries the register facts.
  • market.region carries the province, taken from the applicant, never inferred.
  • The market object carries 16 keys in Canada; a key that is present and null is not known yet, a key that is absent is not part of this market. Keys this market does not carry: annual_turnover, annual_turnover_basis, vat_registered, vat, ein, signup_ip.

Reference

The full field list, types and response schema live on Retrieve a deal, where the country switcher shows this market's example inline.

United States

What the United States market sends on a deal: currency, phone format, company types, validation and the fields that carry a value.

Australia

What the Australia market sends on a deal: currency, phone format, company types, validation and the fields that carry a value.

On this page

At a glanceCompany registerWhat comes back, section by sectionExample registry objectPhone and identifiersBank statementsInstant matchingWhich market fields are populatedCompany typesAmount and revenue bandsExample market objectValidation to expectReference