Tax Rates - Curosa

Overview

The Tax Rates endpoint returns all tax rates configured for your account on the Curosa platform. Tax rate IDs are referenced when creating or updating products to associate the correct tax rate with a product's site pricing.

Authentication

This endpoint requires authentication. Include your API token in the Authorization header. For more information on obtaining a token, see the Authentication guide.

List All Tax Rates

Retrieve a list of all tax rates available to your account.

Endpoint: GET https://curosa.com/api/v1/tax-rates

Request

curl --location 'https://curosa.com/api/v1/tax-rates' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Response

Returns a 200 OK with a data array containing all available tax rates:

{
    "data": [
        {
            "id": 1,
            "name": "Standard Rate",
            "rate": "20.00",
            "country_code": "GB",
            "state_code": null,
            "display_name": "Standard Rate (20%)"
        }
    ]
}

Response Fields:

Field	Type	Description
`id`	integer	Unique identifier for the tax rate. Used when referencing a tax rate in other API calls
`name`	string	Name of the tax rate (e.g. `"Standard Rate"`)
`rate`	string	Tax percentage as a decimal string (e.g. `"20.00"` for 20%)
`country_code`	string	ISO 3166-1 alpha-2 country code this rate applies to (e.g. `"GB"`)
`state_code`	string\|null	State or province code, if the rate is region-specific. `null` means the rate applies to the entire country
`display_name`	string	Formatted label combining name and percentage (e.g. `"Standard Rate (20%)"`)

Using Tax Rate IDs

When setting site pricing on a product, reference the tax rate by its id:

{
    "site_pricing": [
        {
            "site_code": "UK",
            "price": "50.00",
            "price_currency": "GBP",
            "tax_rate_id": 1
        }
    ]
}

Rate Limiting

This endpoint is rate limited to 3,600 requests per hour. The current limit and remaining requests are returned in the response headers as x-ratelimit-limit and x-ratelimit-remaining.