---
title: "Get tax rate for merchant"
method: GET
path: "/v1/tax/tax_rate"
tags: ["Tax"]
---

# Get tax rate for merchant

`GET /v1/tax/tax_rate`

## Request

- Base URL: `https://api.breeze.cash`
- URL: `https://api.breeze.cash/v1/tax/tax_rate`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/breeze/apis/breeze-api/docs/v1/tax/tax_rate/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the tax rate and amount to collect for a given amount, tax source, and currency. Uses the merchant's configured product category. Use the recommended zipcode query object where possible; use the IP query object as a fallback.

## Query parameters

- `queryParams` union: Tax rate query parameters.
  - object
    - `amount` integer, required
    - `currency` string, required
    - `taxSource` 'zipcode', required: Use `zipcode` for country and postal-code based tax calculation.
    - `country` string, required: ISO 3166-1 alpha-2 country code.
    - `zipCode` string: ZIP / postal code. Required for US and CA; optional for other countries.
  - object
    - `amount` integer, required
    - `currency` string, required
    - `taxSource` 'ip', required: Use `ip` for IP-based tax calculation.
    - `country` string, required: ISO 3166-1 alpha-2 country code.
    - `ip` string, required: IP address to use for IP-based tax calculation.

## Response `200`

Success

- object: Tax rate and amount to collect
  - `status` 'SUCCEEDED', required
  - `data` GetMerchantTaxRateResponse, required
    - `taxRate` number, required
    - `amountToCollect` number, required
    - `ipInaccurate` boolean

## Other responses

- `400`: Bad request
- `401`: Unauthorized

## Changes

- **2026-11-03** `4af083d182a6`: 6 warning, 1 info
  - deleted the `query` request parameter `amount`
  - deleted the `query` request parameter `country`
  - deleted the `query` request parameter `currency`
  - deleted the `query` request parameter `ip`
  - …3 more

[Operation history](https://skmtc.dev/breeze/apis/breeze-api/changes/v1/tax/tax_rate/get.md)

---

[API](https://skmtc.dev/breeze/apis/breeze-api.md) - [All operations](https://skmtc.dev/breeze/apis/breeze-api/llms.txt) - [OpenAPI document](https://skmtc.dev/breeze/apis/breeze-api/revisions/4af083d182a6?raw)