Canada GST Verification

overview the canada gst verification api provides a method to verify the validity of a gst (goods and services tax) number associated with a business operating within canada this api helps in confirming the gst registration status of a company on a specified transaction date, ensuring compliance with tax regulations use cases tax compliance helps businesses verify gst numbers during invoice processing or tax filing to ensure compliance with canadian tax laws fraud prevention assists in detecting and preventing fraudulent activities by validating the gst registration status of companies involved in financial transactions b2b verification enables companies to verify the tax registration status of potential or existing business partners, enhancing trust and reliability in b2b transactions api details api details request body pre production curl location 'https //api preproduction signzy us/api/v3/us/canada gst' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "businessname" "alanex llc", "gstnumber" "758740427", "transactiondate" "2024 11 24" }' production curl location 'https //api signzy us/api/v3/us/canada gst' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "businessname" "alanex llc", "gstnumber" "758740427", "transactiondate" "2024 11 24" }' request body mapping parameter type description required businessname string the name of the business to verify this is a supplier's legal, operating, or trading name, displayed on an invoice or posted on a sign at the place of business if you do not get any results using the name displayed, contact the business owner to find out the exact name they gave to the canada revenue agency yes gstnumber string the gst number to be verified enter only the first nine digits of the gst account number do not include letters a supplier must include the gst account number on receipts, invoices, contracts, or other business papers it gives out when it supplies taxable goods or services of $100 or more if you can't find the gst/hst account number, contact your supplier yes transactiondate string the date of the transaction (format yyyy mm dd) the transaction date is the date on the receipt, invoice, contract or other business paper yes response body { "result" { "matchfound" true } } response body mapping field type description matchfound boolean indicates whether a matching gst number was found for the given business on the specified date it can be true or false with 200 status code e rror code response & mapping 200(data not found) { "error" { "name" "error", "message" "data not found for the given input", "status" "404", "reason" "not found", "type" "not found", "statuscode" 200 } } 400(gst error)) { "error" { "name" "error", "message" "gstnumber must be at least 7 characters long ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } 400(date format) { "error" { "name" "error", "message" "transactiondate must be in yyyy mm dd format ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } 400 (field is required) { "error" { "name" "error", "message" "businessname is required ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "gstnumber is required ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "transactiondate is required ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } 401(unauthorized) { "message" "invalid authentication credentials" } 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!