API Docs
API Docs
  1. Endpoints
  2. Sales Tax Rates
  • Getting Started
    • Introduction to Sales Tax Calculation
    • Step By Step - Creating your first transaction
    • Step By Step - Creating VAT / Global Tax Transaction
  • Endpoints
    • Authentication
      • Authentication - Getting Started
      • Create JWT
    • Customers
      • Get to Know
      • Get Customer
      • Get All Customers
      • Upsert Customer
      • Update Customer
    • Exemptions
      • Get to Know
      • Get All Exemptions
      • Post Exemption
      • Update Exemption
      • Patch Exemption
    • Transactions
      • Get to Know
      • The Importance of Shipping Address
      • How to Use Credit Memos
      • Get Transaction (thin)
      • Get Transaction
      • Upsert Transaction
      • Delete Transaction
      • Get All Transactions (thin)
      • Get All Transactions
      • Upsert VAT / GT Transactio
    • Address Validation
      • Address Validation Intro
      • Validate Address
    • Sales Tax Rates
      • Get Sales Tax Rates
        GET
    • Vat Validation
      • Validate Vat
  • Special Features
    • Global Tax Rate
    • Partial Address
    • Discounts
    • Inclusive Tax
    • Vat Validation
    • Post exemptions from CSV
      POST
  1. Endpoints
  2. Sales Tax Rates

Get Sales Tax Rates

GET
/v1/sales_tax_rates
sales_tax_rates
The Sales Tax Rates endpoint returns a rate based on the provided input address. Currently, the endpoint supports addresses within the United States only.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
country
string 
required
The name of the country associated with the address (Max 50 characters). This field is required.
state
string 
required
The state associated with the address (Max 100 characters). This field is required.
zip
string 
required
The ZIP code of the address (Max 20 characters). This field is required.
isPartial
boolean 
required
Indicates whether country, city, or street fields are mandatory.
city
string 
optional
The name of the city associated with the address (Max 100 characters).
county
string 
optional
The county associated with the address (Max 100 characters).
street
string 
optional
The street address (Max 200 characters).
effectiveDate
string 
optional
Date format - YYYY-MM-DD, default value now if not sent

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sandbox.complyt.io/v1/sales_tax_rates?country&state&zip&isPartial&city&county&street&effectiveDate'

Responses

🟢200Successful operation
application/json
Body
complytId
string 
required
Unique identifier for the request.
requestAddress
object 
required
The original address provided in the request.
address
object 
required
Details of the requested address.
effectiveDate
string <date-time>
required
Effective date of the request.
matchedAddressData
object 
required
Details of the real address in the US based on the request address.
address
object 
required
Matched address details.
scoring
object 
required
Scoring data for the matched address.
salesTaxRates
object 
required
Tax rate details for the matched address.
stateRate
number 
required
State tax rate.
countyRate
number 
required
County tax rate.
cityRate
number 
required
City tax rate.
mtaRate
number 
required
Metropolitan tax rate.
spdRate
number 
required
Special district tax rate.
otherRate
number 
required
Other applicable tax rates.
taxRate
number 
required
Total tax rate applicable.
Examples
{
  "complytId": "414d3ef7-e282-4e29-9c77-ba7d3a349c33",
  "requestAddress": {
    "address": {
      "country": "US",
      "state": "NY",
      "zip": "10001",
      "isPartial": true
    },
    "effectiveDate": "2024-01-01T00:00:00"
  },
  "matchedAddressData": {
    "address": {
      "city": "New York",
      "country": "United States",
      "county": "New York",
      "state": "New York",
      "zip": "10001"
    },
    "scoring": {
      "matchLevel": "EXCELLENT",
      "score": 1,
      "fieldScore": {
        "countryMatch": "EXACT",
        "stateMatch": "EXACT",
        "cityMatch": "NO_MATCH",
        "zipMatch": "EXACT"
      }
    }
  },
  "salesTaxRates": {
    "stateRate": 0.04,
    "countyRate": 0,
    "cityRate": 0.045,
    "spdRate": 0,
    "mtayRate": 0,
    "otherRate": 0,
    "combinedDistrictRate": 0.00375,
    "ratesMetaData": {
      "cityDistrictRate": 0,
      "countyDistrictRate": 0.00375,
      "specialDistrictRate": 0
    },
    "taxRate": 0.08875
  }
}
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🔴500Internal Error
Modified at 2025-02-12 14:17:40
Previous
Validate Address
Next
Validate Vat
Built with