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

Request Body

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"
}'

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.

Error Code Response & Mapping

{
    "error": {
        "name": "error",
        "message": "Data not found for the given input",
        "status": "404",
        "reason": "NOT_FOUND",
        "type": "Not Found",
        "statusCode": 200
    }
}

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 [email protected]. 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!