Canada KYB Verification

overview the canada kyb (know your business) verification api enables real time verification of canadian businesses using official registry data this api checks details like business name, business number, and registry id against governmental databases to ensure accuracy and validity of business credentials usecase financial compliance and risk management banks and financial institutions can utilize this api to perform due diligence during the account opening process for business clients, ensuring compliance with anti money laundering (aml) regulations and assessing the risk profile of the business insurance companies might use it to verify business details before underwriting commercial insurance policies, minimizing the risk of fraud business onboarding for fintech platforms fintech startups focused on business to business services can integrate this api to automate and streamline the verification process of businesses during onboarding, ensuring that they only deal with legitimate entities and reducing manual verification workload supplier and partner verification manufacturing and retail companies can use this api to verify the legitimacy of new suppliers or partners before entering into contracts, thus ensuring the reliability and regulatory compliance of their supply chain e commerce platforms may use it to authenticate sellers during registration, enhancing trust and security for buyers legal and contractual due diligence law firms and legal service providers can utilize the api to verify the status and legitimacy of businesses as part of the due diligence for mergers and acquisitions, investments, or other legal agreements real estate firms might find it useful to confirm the status of commercial clients before finalizing leases or purchases of property coverage our information is provided by the official business registries of alberta british columbia manitoba nova scotia ontario québec saskatchewan corporations canada we are in the process of incorporating data from additional business registries please note that our service does not include information on financial institutions, such as banks or insurance companies api details request body pre production curl location 'https //api preproduction signzy us/api/v3/us/canada kyb fetch' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data '{ "businessname" "first quantum minerals ltd ", "businessnumber" "131350431", "registryid" "bc1006807", "statusfilter" "all" }' production curl location 'https //api signzy us/api/v3/us/canada kyb fetch' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data '{ "businessname" "first quantum minerals ltd ", "businessnumber" "131350431", "registryid" "bc1006807", "statusfilter" "all" }' api input mapping all the three inputs are optional, but any one of the input must be entered to run the api field type description required businessname string the name of the business to verify optional atleast 1 of the inputs is mandatory businessnumber string the business number which is common to the whole canada optional atleast 1 of the inputs is mandatory registryid string business registry id specific to different states associated with the respective business optional atleast 1 of the inputs is mandatory statusfilter string there can be multiple companies in the output this parameter can be used to filter only active or inactive companies optional possible values active will filter only active status companies inactive will filter inactive status companies all will show all companies sample response { "result" { { "name" "first quantum minerals ltd ", "business number bn" " ", "registry id" "1169271963", "registered office location" "vancouver, colombie britannique", "status" "active", "status notes" " ", "business type" "société par actions ou compagnie", "created" "2013 04 23" }, { "name" "first quantum minerals ltd ", "business number bn" " ", "registry id" "a0043679", "status" "inactive", "status notes" "amalgamated", "business type" "non canadian corporation", "registered in" "british columbia", "registration date" " " } } } response body mapping parameter type description businessname string the official name of the business businessnumber string the business number associated with the business registryid string the registry identification number associated with the business registeredofficelocation string location of the business's registered office status string current status of the business statusnotes string additional notes regarding the business status businesstype string type of business as registered createddate/registrationdate string date of creation or registration of the business registeredin string province in which the business is registered e rror code response & mapping 400(bad request) { "error" { "name" "error", "message" "businessnumber/registryid must be at least 5 characters long ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } 401(unauthorized) { "message" "invalid authentication credentials" } 403(forbidden { "error" { "name" "error", "message" "forbidden", "reason" "error", "type" "bad request", "statuscode" "403" } } 500(internal server error) { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "bad request", "statuscode" "500" } } 409(upstream down error) { "error" { "name" "error", "message" "upstream down", "status" 409, "reason" "error", "type" "conflict", "statuscode" "409" } } field type description name string text displayed on the screen explaining error type reason string reason for the error status number http status code message string error message indicating an upstream error type string error type statuscode string status code representing the error scenario getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!