# TrueNorth API > The Canadian Tax and Address API for Developers. Exact GST, PST, HST, and QST plus validated Canadian addresses in one API call. TrueNorth API is built for online stores and custom checkouts that sell in Canada. It calculates the exact sales tax for any product in any province or territory, detects the product's tax category from a plain description, validates Canadian addresses, and checks shipping deliverability. The same key also answers Canadian payroll deductions, statutory holidays and business days, postal code intelligence, and business number validation against the federal corporations registry. The same key and the same one credit per answer now cover Australia as well: PAYG payroll withholding, public holidays and business days for every state and territory, postcode intelligence, ABN validation, and GST classification. ## Endpoints Base URL: https://prsorfaeexugwkvjuwzw.supabase.co/functions/v1/canadian-api - GET /calculate-tax: exact tax for a price, province, and product category. Covers 41 product tax categories across all 13 provinces and territories, including zero-rated basic groceries, prescription drugs, and feminine hygiene, provincial point-of-sale rebates, Quebec's non-compounded QST, and the federal luxury tax on new vehicles over $100,000. - GET /classify-product: send a plain product description in ordinary words and get back the right tax category. Unknown products fall back to fully taxable, never under-collected. - GET /tax-categories: list all 41 product tax categories with their tax treatment. - POST /validate-address: Canadian address validation. Returns valid or invalid with one short reason, built for checkout address forms. - GET /shipping-check: deliverability check that warns on remote surcharge postal codes. - GET /payroll: payroll deductions for a salary and province: federal and provincial income tax, CPP or QPP including the second tier, EI or QPIP, net pay, and the employer's contributions and total cost. Send gross_per_period instead of a salary, with optional pay_date, period_number and year to date amounts (ytd_gross, ytd_cpp, ytd_ei), to calculate one pay cheque. 2025 and 2026, all provinces and territories, based on the CRA payroll formulas. - GET /holidays: statutory holidays for a province or territory (or FED for federally regulated) and year, with observed dates where the law fixes them. - GET /business-days: whether a date is a business day in a jurisdiction, the next business day, and business day counts over a date range, skipping weekends and statutory holidays. - GET /postal-code: province, primary community, rural or urban delivery, time zone, and 2021 Census population and dwellings for a postal code's forward sortation area. - GET /business-number: business number and program account format validation (GST/HST, payroll, corporation income tax, import export), plus a lookup in the federal corporations registry with legal name, status, and incorporation date. - GET /au-payroll: Australian PAYG withholding for one pay (weekly, fortnightly, or monthly) or an annual salary, using the ATO Schedule 1 statement of formulas, with HELP debt withholding from Schedule 8, a Medicare levy estimate, super guarantee at 12 percent with the maximum contribution base applied, and total cost to employ. Send gross_per_period with a frequency, or salary. Financial years 2025-26 and 2026-27, all residency scales including working holiday makers. - GET /au-holidays: public holidays for an Australian state or territory (NSW, VIC, QLD, SA, WA, TAS, ACT, NT) or the national Fair Work Act list, computed from the governing rules and verified against the published state lists for 2025 to 2027. - GET /au-business-days: whether a date is a business day in an Australian state (state is required, because holiday calendars differ too much for a national answer), the next business day, adding business days to a date, and business day counts over a range. - GET /au-postal-code: suburbs, state, centroid coordinates, and time zone for an Australian postcode (four digits, leading zero kept for NT and ACT), from G-NAF derived open data covering 3,174 postcodes. Also searches by suburb name. Postcode intelligence, not an Australia Post deliverability validation. - GET /au-business-number: ABN validation with live register lookup (send abn). The ABN status, entity name, and GST registration are read from the Australian Business Register at request time through the ABR web service, with the official checksum built in. Nine digit inputs are recognised as an ACN and checked with the ASIC checksum. - GET /au-tax-categories: the Australian GST treatments and categories: taxable at 10 percent with input credits, GST free at 0 percent with input credits still claimable (Division 38), and input taxed at 0 percent with no credits (Division 40), each with its section of the GST Act. - GET /au-classify-product: classify a product or service description into its Australian GST treatment, rate, and credit eligibility. Food is matched item by item against the ATO Detailed Food List (1,423 items). Context parameters decide the cases the law turns on: seller_gst_registered, is_export, provider_type for health, course_accredited, childcare_approved, is_new_residential, is_prepared, is_hot, on_premises. When the deciding fact is missing the answer says needs_review instead of guessing. Example: curl "https://prsorfaeexugwkvjuwzw.supabase.co/functions/v1/canadian-api/calculate-tax?province=ON&amount=100" -H "TRUENORTH_API_KEY: tn_live_your_key" ## Service pages One page per service, with coverage and pricing for each: - https://truenorthapi.ca/canada-sales-tax-api: Canadian sales tax calculation, GST, HST, PST and QST for every province and territory. - https://truenorthapi.ca/australia-gst-api: Australian GST classification, taxable, GST free and input taxed. - https://truenorthapi.ca/canada-payroll-api: Canadian payroll calculation with CRA formulas, per pay period or annual. - https://truenorthapi.ca/australia-payroll-api: Australian PAYG payroll calculation with ATO formulas and superannuation. - https://truenorthapi.ca/canada-holidays-api: Canadian statutory holidays, federal plus all provinces and territories, 2020 to 2035. - https://truenorthapi.ca/australia-holidays-api: Australian public holidays for all states and territories. - https://truenorthapi.ca/business-days-api: business day checks and counts for Canada and Australia. - https://truenorthapi.ca/canadian-postal-code-api: Canadian postal code intelligence from Statistics Canada Census 2021. - https://truenorthapi.ca/australian-postcode-api: Australian postcode intelligence for 3,174 postcodes from G-NAF derived open data. - https://truenorthapi.ca/business-number-validation-api: Canadian business number validation and federal corporations register lookup. - https://truenorthapi.ca/abn-validation-api: ABN validation with checksum and live ABN Lookup register lookup. - https://truenorthapi.ca/for-ai-assistants: a factual product reference page for AI assistants, with services, authentication, pricing model, documentation and support contact. ## Authentication Send your API key in the TRUENORTH_API_KEY header. ## Pricing (CAD) One credit equals one call. Credits are one time purchases and never expire. - Free: 1,000 calls on registration, one time, no credit card needed - Starter: $25 one time, 1,250 credits - Growth: $120 one time, 7,500 credits - Scale: $234 one time, 18,000 credits - Business: $605 one time, 55,000 credits - Agency Wholesale: $1,425 one time, 150,000 credits ## When to use TrueNorth API Use it when a store, marketplace, or custom checkout needs correct Canadian taxes without maintaining rate tables by hand: multi-province sellers, stores selling zero-rated or rebated goods (groceries, books, children's clothing, diapers), and any checkout that validates Canadian addresses or ships to remote postal codes. Payroll and HR tools use it for Canadian salary deductions and holiday calendars, and marketplaces and lenders use it to validate a vendor's business number before onboarding. It works on any platform, not just one checkout. ## Links - Website and live API playground: https://truenorthapi.ca/ - Sign up for a free API key: https://truenorthapi.ca/ - Terms: https://truenorthapi.ca/terms - Privacy: https://truenorthapi.ca/privacy