Name: Canada Sales Tax API: GST, HST, PST and QST Calculator
Brand: steadyscrape
SKU: api-steadyscrape-canada-sales-tax-qst-calculator
Availability: InStock
Author: API Market

# Canada Sales Tax & QST Calculator API

## Overview

The Canada Sales Tax & QST Calculator API returns the GST, HST, PST and QST for any Canadian province or territory on any date since April 1, 2013. Pass a net amount and a province to get each tax component, the total tax and the gross, or pass a tax-included total to work backwards to the net. Every component carries its rate, the dates it was in force and the official CRA, Revenu Québec or provincial page it comes from. Costa Rica IVA is also supported.

It is built for developers of invoicing, e-commerce, point of sale, accounting and subscription billing software that sell to Canadian customers. In our tests $100 in Quebec returned GST 5.00 and QST 9.98 for a total of 114.98, a 115.00 total in Nova Scotia on 2025-03-31 reversed to 100.00 at the old 15% HST, and Manitoba on 2019-06-30 returned the 8% PST in force before July 2019.

## Features

*   **6 endpoints**: calculate, reverse (GET and POST each), rates on a date, and health.
*   **All 13 provinces and territories**: GST, HST, PST and QST, split by component with French names.
*   **Dated rates**: pass `date` to get the rate in force that day, back to 2013-04-01.
*   **Reverse calculation**: net and each tax from a tax-included total, with any rounding difference reported.
*   **Invoice lines**: up to 100 lines per call, rounded per line or once per invoice.
*   **Official sources**: every component returns the source page it was checked against.
*   **Costa Rica IVA**: general 13% rate and the reduced rates.

## Use Cases

*   **Invoicing**: add the right Canadian taxes to every invoice line.
*   **E-commerce checkout**: show tax by province before payment.
*   **Point of sale**: compute QST and GST to the cent at the till.
*   **Accounting and refunds**: split a tax-included total into net and tax for bookkeeping.
*   **Back-dated corrections**: recalculate old invoices with the rate in force on the original date.

## API Documentation

### Base URL

All requests use the following base URL.

```
https://prod.api.market/api/v1/steadyscrape/canada-sales-tax-qst-calculator
```

### Authentication

All requests are authenticated with the `x-api-market-key` header.

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Calculate tax from a net amount (GET)

Returns each tax component, the total tax and the gross for a net amount.

**Method:** `GET`

**Endpoint:** `/v1/tax/calculate`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `country` | query | `CA` for Canada or `CR` for Costa Rica IVA | string | No | `CA` | - |
| `province` | query | Province or territory code (`QC`, `ON`, `BC`) or its English or French name. Required for Canada. | string | No | - | - |
| `amount` | query | Amount before tax. A number or a string, French decimal comma and `$` accepted. | string | Yes | - | 1e12 |
| `date` | query | Transaction date as `YYYY-MM-DD`. The rate in force that day is used. Canada starts at 2013-04-01. | string | No | today (UTC) | - |
| `tax` | query | Return only one component: `GST`, `HST`, `PST`, `QST` or the French `TPS`, `TVH`, `TVP`, `TVQ` | string | No | - | - |
| `code` | query | Costa Rica IVA code: `GENERAL`, `R4`, `R4_INTL_AIR`, `R2`, `R1` or `R0_5` | string | No | `GENERAL` | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/canada-sales-tax-qst-calculator/v1/tax/calculate?country=CA&province=QC&amount=100.00' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "country": "CA",
  "province": "QC",
  "province_name": "Quebec",
  "province_name_fr": "Québec",
  "date": "2026-11-10",
  "net": "100.00",
  "total_tax": "14.98",
  "gross": "114.98",
  "total_rate_pct": "14.975",
  "components": [
    {
      "tax": "GST",
      "name_fr": "TPS",
      "rate_pct": "5",
      "amount": "5.00",
      "effective_from": "2013-04-01",
      "effective_to": null,
      "source_url": "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html",
      "source_urls": [
        "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html"
      ]
    },
    {
      "tax": "QST",
      "name_fr": "TVQ",
      "rate_pct": "9.975",
      "amount": "9.98",
      "effective_from": "2013-04-01",
      "effective_to": null,
      "source_url": "https://www.revenuquebec.ca/fr/entreprises/taxes/tpstvh-et-tvq/perception-de-la-tps-et-de-la-tvq/calcul-des-taxes/",
      "source_urls": [
        "https://www.revenuquebec.ca/fr/entreprises/taxes/tpstvh-et-tvq/perception-de-la-tps-et-de-la-tvq/calcul-des-taxes/"
      ]
    }
  ],
  "warnings": [],
  "table_version": "2026-11-02",
  "disclaimer": "Rate lookup and arithmetic only, not tax advice. You choose the province or IVA code; verify with the CRA, Revenu Québec, your province or Hacienda."
}
```

For Costa Rica, set `country=CR` and a `code`. `GET /v1/tax/calculate?country=CR&amount=1000&code=R4` returned `iva` 40.00 and `gross` 1040.00.

#### 2. Calculate tax for invoice lines (POST)

Same as the GET call, or send up to 100 invoice `lines`. A call with 100 lines counts as one request.

**Method:** `POST`

**Endpoint:** `/v1/tax/calculate`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `country` | body | `CA` for Canada or `CR` for Costa Rica IVA | string | No | `CA` | - |
| `province` | body | Province or territory code (`QC`, `ON`, `BC`) or its English or French name. Required for Canada. | string | No | - | - |
| `amount` | body | Amount before tax, when not sending `lines` | string | No | - | 1e12 |
| `date` | body | Transaction date as `YYYY-MM-DD`. The rate in force that day is used. Canada starts at 2013-04-01. | string | No | today (UTC) | - |
| `tax` | body | Return only one component: `GST`, `HST`, `PST`, `QST` or the French `TPS`, `TVH`, `TVP`, `TVQ` | string | No | - | - |
| `code` | body | Costa Rica IVA code: `GENERAL`, `R4`, `R4_INTL_AIR`, `R2`, `R1` or `R0_5` | string | No | `GENERAL` | - |
| `lines` | body | Invoice lines, each an amount or an object with `amount` and optional `description` | array | No | - | 100 lines |
| `rounding` | body | `per_line` rounds each line tax then adds, `invoice` taxes the summed net once | string | No | `per_line` | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/steadyscrape/canada-sales-tax-qst-calculator/v1/tax/calculate' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"province": "ON", "lines": [{"amount": 49.99, "description": "Plan"}, {"amount": 12.5}], "rounding": "per_line"}'
```

**Example Response (200 OK):**

```json
{
  "country": "CA",
  "province": "ON",
  "province_name": "Ontario",
  "province_name_fr": "Ontario",
  "date": "2026-11-10",
  "net": "62.49",
  "total_tax": "8.13",
  "gross": "70.62",
  "total_rate_pct": "13",
  "components": [
    {
      "tax": "HST",
      "name_fr": "TVH",
      "rate_pct": "13",
      "amount": "8.13",
      "effective_from": "2013-04-01",
      "effective_to": null,
      "source_url": "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html",
      "source_urls": [
        "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html"
      ]
    }
  ],
  "warnings": [],
  "rounding": "per_line",
  "lines": [
    {
      "line": 1,
      "description": "Plan",
      "net": "49.99",
      "total_tax": "6.50",
      "gross": "56.49",
      "components": [
        {
          "tax": "HST",
          "amount": "6.50"
        }
      ]
    },
    {
      "line": 2,
      "net": "12.50",
      "total_tax": "1.63",
      "gross": "14.13",
      "components": [
        {
          "tax": "HST",
          "amount": "1.63"
        }
      ]
    }
  ],
  "table_version": "2026-11-02",
  "disclaimer": "Rate lookup and arithmetic only, not tax advice. You choose the province or IVA code; verify with the CRA, Revenu Québec, your province or Hacienda."
}
```

#### 3. Reverse a tax-included total (GET)

Returns the net and each tax from a total that already includes tax. `rounding_difference` shows any one-cent difference instead of hiding it.

**Method:** `GET`

**Endpoint:** `/v1/tax/reverse`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `country` | query | `CA` for Canada or `CR` for Costa Rica IVA | string | No | `CA` | - |
| `province` | query | Province or territory code (`QC`, `ON`, `BC`) or its English or French name. Required for Canada. | string | No | - | - |
| `gross` | query | Tax-included total | string | Yes | - | 1e12 |
| `date` | query | Transaction date as `YYYY-MM-DD`. The rate in force that day is used. Canada starts at 2013-04-01. | string | No | today (UTC) | - |
| `tax` | query | Return only one component: `GST`, `HST`, `PST`, `QST` or the French `TPS`, `TVH`, `TVP`, `TVQ` | string | No | - | - |
| `code` | query | Costa Rica IVA code: `GENERAL`, `R4`, `R4_INTL_AIR`, `R2`, `R1` or `R0_5` | string | No | `GENERAL` | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/canada-sales-tax-qst-calculator/v1/tax/reverse?country=CA&province=NS&gross=115.00&date=2025-03-31' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "country": "CA",
  "province": "NS",
  "province_name": "Nova Scotia",
  "province_name_fr": "Nouvelle-Écosse",
  "date": "2025-03-31",
  "net": "100.00",
  "total_tax": "15.00",
  "gross": "115.00",
  "total_rate_pct": "15",
  "rounding_difference": "0.00",
  "components": [
    {
      "tax": "HST",
      "name_fr": "TVH",
      "rate_pct": "15",
      "amount": "15.00",
      "effective_from": "2013-04-01",
      "effective_to": "2025-03-31",
      "source_url": "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html",
      "source_urls": [
        "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html"
      ]
    }
  ],
  "warnings": [],
  "table_version": "2026-11-02",
  "disclaimer": "Rate lookup and arithmetic only, not tax advice. You choose the province or IVA code; verify with the CRA, Revenu Québec, your province or Hacienda."
}
```

#### 4. Reverse a tax-included total (POST)

Same as the GET call, with the values in a JSON body.

**Method:** `POST`

**Endpoint:** `/v1/tax/reverse`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `country` | body | `CA` for Canada or `CR` for Costa Rica IVA | string | No | `CA` | - |
| `province` | body | Province or territory code (`QC`, `ON`, `BC`) or its English or French name. Required for Canada. | string | No | - | - |
| `gross` | body | Tax-included total | string | Yes | - | 1e12 |
| `date` | body | Transaction date as `YYYY-MM-DD`. The rate in force that day is used. Canada starts at 2013-04-01. | string | No | today (UTC) | - |
| `tax` | body | Return only one component: `GST`, `HST`, `PST`, `QST` or the French `TPS`, `TVH`, `TVP`, `TVQ` | string | No | - | - |
| `code` | body | Costa Rica IVA code: `GENERAL`, `R4`, `R4_INTL_AIR`, `R2`, `R1` or `R0_5` | string | No | `GENERAL` | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/steadyscrape/canada-sales-tax-qst-calculator/v1/tax/reverse' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"province": "BC", "gross": "112.00"}'
```

**Example Response (200 OK):**

```json
{
  "country": "CA",
  "province": "BC",
  "province_name": "British Columbia",
  "province_name_fr": "Colombie-Britannique",
  "date": "2026-11-10",
  "net": "100.00",
  "total_tax": "12.00",
  "gross": "112.00",
  "total_rate_pct": "12",
  "rounding_difference": "0.00",
  "components": [
    {
      "tax": "GST",
      "name_fr": "TPS",
      "rate_pct": "5",
      "amount": "5.00",
      "effective_from": "2013-04-01",
      "effective_to": null,
      "source_url": "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html",
      "source_urls": [
        "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html"
      ]
    },
    {
      "tax": "PST",
      "name_fr": "TVP",
      "rate_pct": "7",
      "amount": "7.00",
      "effective_from": "2013-04-01",
      "effective_to": null,
      "source_url": "https://www2.gov.bc.ca/gov/content/taxes/sales-taxes/pst/publications/small-business-guide",
      "source_urls": [
        "https://www2.gov.bc.ca/gov/content/taxes/sales-taxes/pst/publications/small-business-guide"
      ]
    }
  ],
  "warnings": [],
  "table_version": "2026-11-02",
  "disclaimer": "Rate lookup and arithmetic only, not tax advice. You choose the province or IVA code; verify with the CRA, Revenu Québec, your province or Hacienda."
}
```

#### 5. Rates on a date

Returns the rates in force on a date for one province, or for all 13 when `province` is left out, with their sources.

**Method:** `GET`

**Endpoint:** `/v1/tax/rates`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `country` | query | `CA` for Canada or `CR` for Costa Rica IVA | string | No | `CA` | - |
| `province` | query | Province or territory code. Leave out to list all 13. | string | No | - | - |
| `date` | query | Transaction date as `YYYY-MM-DD`. The rate in force that day is used. Canada starts at 2013-04-01. | string | No | today (UTC) | - |
| `code` | query | Costa Rica IVA code: `GENERAL`, `R4`, `R4_INTL_AIR`, `R2`, `R1` or `R0_5` | string | No | `GENERAL` | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/canada-sales-tax-qst-calculator/v1/tax/rates?country=CA&province=MB&date=2019-06-30' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "country": "CA",
  "province": "MB",
  "province_name": "Manitoba",
  "province_name_fr": "Manitoba",
  "date": "2019-06-30",
  "total_rate_pct": "13",
  "components": [
    {
      "tax": "GST",
      "name_fr": "TPS",
      "rate_pct": "5",
      "effective_from": "2013-04-01",
      "effective_to": null,
      "source_url": "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html",
      "source_urls": [
        "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/calculator.html"
      ]
    },
    {
      "tax": "PST",
      "name_fr": "TVP",
      "rate_pct": "8",
      "effective_from": "2013-07-01",
      "effective_to": "2019-06-30",
      "source_url": "https://www.gov.mb.ca/finance/taxation/pubs/bulletins/noticerst1308.pdf",
      "source_urls": [
        "https://www.gov.mb.ca/finance/taxation/pubs/bulletins/noticerst1308.pdf"
      ]
    }
  ],
  "warnings": [],
  "table_version": "2026-11-02",
  "disclaimer": "Rate lookup and arithmetic only, not tax advice. You choose the province or IVA code; verify with the CRA, Revenu Québec, your province or Hacienda."
}
```

#### 6. Health

Returns the service status and the version of the rate table.

**Method:** `GET`

**Endpoint:** `/v1/tax/health`

**Parameters:**

None.

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/canada-sales-tax-qst-calculator/v1/tax/health' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "ok": true,
  "table_version": "2026-11-02",
  "disclaimer": "Rate lookup and arithmetic only, not tax advice. You choose the province or IVA code; verify with the CRA, Revenu Québec, your province or Hacienda."
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the JSON result is in the response body. |
| 400 | Bad Request | A parameter is missing or invalid, for example an unknown province. The error has a `code` and a message in English and French. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key does not have an active subscription that includes this endpoint. |
| 404 | Not Found | The path does not match an endpoint of this API. Check the Base URL and path. |
| 422 | Unprocessable Entity | The date is outside the rate table, for example before 2013-04-01 for Canada. |
| 429 | Too Many Requests | You went over the requests per second of your plan or used up its quota. |
| 500 | Internal Server Error | The request failed on the server. Retry once, then contact us if it continues. |
| 503 | Service Unavailable | The service is temporarily unavailable. Retry after a short wait. |

## Rate Limits

The Free and Starter plans allow 1 request per second, Pro allows 2 and Business allows 4. Each plan has a monthly quota and requests stop at the quota, with no overage billing. When you go over a limit, the API returns `429 Too Many Requests`. Throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **Does it decide which province applies?**
    No. You pass the province. The API does not decide place of supply, exemptions, zero-rating or goods-specific rates.

*   **Can I send province names?**
    Yes. Codes such as `QC` and English or French names such as `Québec` are accepted.

*   **How is rounding handled?**
    Each tax is rounded half-up to the cent. For invoice lines, `rounding` chooses between rounding per line and once per invoice.

*   **What does an unknown province return?**
    400 with `BAD_PROVINCE` and a message in English and French.

*   **Is this tax advice?**
    No. It is a rate lookup and calculation. Check results with the CRA, Revenu Québec, your province or Costa Rica Hacienda before filing.

## Contact Us

If you have any questions or need support, reach out through the chat embedded on this page or email us at hello@magicapi.com.


Calculate Canadian GST, HST, PST and QST for any province on any date since 2013, with reverse totals, invoice lines and official sources.

Canada Sales Tax API: GST, HST, PST and QST Calculator

Free