---
title: "List GST tax rates"
method: GET
path: "/public/v2/gst-tax-rates/"
tags: ["GST Tax Rates"]
---

# List GST tax rates

`GET /public/v2/gst-tax-rates/`

Retrieve a paginated list of GST tax rates available for the organization.

Use the `id` field as `gst_tax_rate_id` when creating or updating transaction line items
(invoices, bills, journal entries, etc.) with GST tax data.

Includes component breakdown (e.g., CGST + SGST for India intra-state, GST + PST for
Canadian provinces) when applicable.

Filter by `country_code`, `tax_treatment`, or `is_active` to narrow results.

## Query parameters

- `country_code` GstCountries[], nullable
- `tax_treatment` 'STANDARD' | 'ZERO_RATED' | 'EXEMPT' | 'IMPORT_GST' | 'REVERSE_CHARGE' | 'SELF_ASSESSED' | 'OUT_OF_SCOPE', nullable
- `is_active` boolean, nullable
- `limit` integer — Number of records to return per page (capped at 100)
- `offset` integer — Number of records to skip before starting to return results

## Response `200`

OK

- PagedPublicGstTaxRateSchemaOut
  - `items` PublicGstTaxRateSchemaOut[], required
    - `id` integer, required
    - `country_code` string, required
    - `name` string, required
    - `rate` string, required
    - `tax_treatment` 'STANDARD' | 'ZERO_RATED' | 'EXEMPT' | 'IMPORT_GST' | 'REVERSE_CHARGE' | 'SELF_ASSESSED' | 'OUT_OF_SCOPE', required
    - `supply_category` 'INTRA_STATE' | 'INTER_STATE' — India GST: intra-state (CGST+SGST) vs inter-state (IGST).
    - `region` string, nullable
    - `valid_from` string, date, required
    - `valid_to` string, date, nullable, required
    - `is_active` boolean, required
    - `is_system` boolean, required
    - `description` string, nullable, required
    - `components` PublicGstTaxRateComponentSchemaOut[], required
      - `id` integer, required
      - `component_type` 'CGST' | 'SGST' | 'IGST' | 'CESS' | 'GST' | 'PST' | 'HST' | 'QST', required
      - `rate` string, required
      - `region` string, nullable, required
      - `position` integer, required
  - `count` integer, required

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/dualentry/apis/dualentry-public-api.md) · [All operations](https://skmtc.net/dualentry/apis/dualentry-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dualentry/dualentry-public-api/revisions/eddf3ef279e2/schema)