{
  "openapi": "3.1.0",
  "info": {
    "title": "Sales Tax & VAT API",
    "version": "1.0.0",
    "description": "VAT and GST rates for 52 countries, US state sales tax for all 50 states, and a calculator.\n\nVAT and GST standard and reduced rates for 52 countries, US state base sales-tax rates for all 50 states plus DC, and a calculator that splits any amount into net, tax and gross (tax-inclusive or exclusive). Every rate is verified against published government and tax-authority sources (listed in /v1/sources), and known scheduled changes are encoded with their effective dates so the API updates itself the day a rate changes — no stale snapshots.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/sales-tax.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/sales-tax-vat"
  },
  "servers": [
    {
      "url": "https://api-sales-tax.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Finance",
      "description": "Sales Tax & VAT API belongs to the Finance category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/calculate": {
      "get": {
        "operationId": "calculateTax",
        "summary": "Calculate Tax",
        "description": "Calculate Tax endpoint of the Sales Tax & VAT API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/sales-tax-vat/calculate-tax"
        },
        "parameters": [
          {
            "name": "amount",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "100"
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "DE"
          },
          {
            "name": "inclusive",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "false"
          },
          {
            "name": "rate",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "8.25"
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "CA"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "as_of": "2026-09",
                  "rate": 19,
                  "rate_source": "Germany VAT standard rate",
                  "amount_is_inclusive": false,
                  "net": 100,
                  "tax": 19,
                  "gross": 119,
                  "disclaimer": "Rates are state/country base rates as of 2026-09; local surcharges and category-specific rates may apply. Verify before relying on them for tax filings."
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/sources": {
      "get": {
        "operationId": "dataSources",
        "summary": "Data Sources",
        "description": "Data Sources endpoint of the Sales Tax & VAT API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/sales-tax-vat/data-sources"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "as_of": "2026-09",
                  "sources": [
                    {
                      "name": "VATupdate — Global VAT rates by country (mid-year 2026 update)",
                      "url": "https://www.vatupdate.com/2026/07/25/global-vat-rates-by-country-2026-standard-and-reduced-rates/",
                      "verified": "2026-09-11"
                    },
                    {
                      "name": "Fiscalead — VAT rates in Europe 2026",
                      "url": "https://www.fiscalead.com/en/vat-rates-in-europe-in-2026-full-review-by-country/",
                      "verified": "2026-09-11"
                    },
                    {
                      "name": "Sales Tax Institute — State sales tax rates (updated 2026-09-01)",
                      "url": "https://www.salestaxinstitute.com/resources/rates",
                      "verified": "2026-09-11"
                    },
                    {
                      "name": "Tax Foundation — State and Local Sales Tax Rates, Midyear 2026",
                      "url": "https://taxfoundation.org/data/all/state/2026-sales-tax-rates-midyear/",
                      "verified": "2026-09-11"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/vat": {
      "get": {
        "operationId": "listVatRates",
        "summary": "List VAT Rates",
        "description": "List VAT Rates endpoint of the Sales Tax & VAT API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/sales-tax-vat/list-vat-rates"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "as_of": "2026-09",
                  "count": 52,
                  "rates": [
                    {
                      "country": "Austria",
                      "code": "AT",
                      "tax_name": "VAT",
                      "standard_rate": 20,
                      "reduced_rates": [
                        10,
                        13
                      ],
                      "note": "Temporary 5% rate on basic foodstuffs announced from 1 Jul 2026."
                    },
                    {
                      "country": "Belgium",
                      "code": "BE",
                      "tax_name": "VAT",
                      "standard_rate": 21,
                      "reduced_rates": [
                        6,
                        12
                      ]
                    },
                    {
                      "country": "Bulgaria",
                      "code": "BG",
                      "tax_name": "VAT",
                      "standard_rate": 20,
                      "reduced_rates": [
                        9
                      ]
                    },
                    "... 49 more countries omitted from this example"
                  ],
                  "disclaimer": "Rates are state/country base rates as of 2026-09; local surcharges and category-specific rates may apply. Verify before relying on them for tax filings."
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/sales-tax/us/{state}": {
      "get": {
        "operationId": "usSalesTax",
        "summary": "US Sales Tax",
        "description": "US Sales Tax endpoint of the Sales Tax & VAT API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/sales-tax-vat/us-sales-tax"
        },
        "parameters": [
          {
            "name": "state",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "CA"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "as_of": "2026-09",
                  "state": "California",
                  "code": "CA",
                  "base_rate": 7.25,
                  "note": "6% state rate plus the mandatory 1.25% statewide local rate.",
                  "disclaimer": "Rates are state/country base rates as of 2026-09; local surcharges and category-specific rates may apply. Verify before relying on them for tax filings."
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/sales-tax/us": {
      "get": {
        "operationId": "usSalesTaxAllStates",
        "summary": "US Sales Tax (All States)",
        "description": "US Sales Tax (All States) endpoint of the Sales Tax & VAT API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/sales-tax-vat/us-sales-tax-all-states"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "as_of": "2026-09",
                  "count": 51,
                  "states": [
                    {
                      "state": "Alabama",
                      "code": "AL",
                      "base_rate": 4
                    },
                    {
                      "state": "Alaska",
                      "code": "AK",
                      "base_rate": 0,
                      "note": "No state sales tax; localities may levy their own."
                    },
                    {
                      "state": "Arizona",
                      "code": "AZ",
                      "base_rate": 5.6
                    }
                  ],
                  "disclaimer": "Rates are state/country base rates as of 2026-09; local surcharges and category-specific rates may apply. Verify before relying on them for tax filings."
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/vat/{country}": {
      "get": {
        "operationId": "vatByCountry",
        "summary": "VAT By Country",
        "description": "VAT By Country endpoint of the Sales Tax & VAT API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/sales-tax-vat/vat-by-country"
        },
        "parameters": [
          {
            "name": "country",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "DE"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "as_of": "2026-09",
                  "country": "Germany",
                  "code": "DE",
                  "tax_name": "VAT",
                  "standard_rate": 19,
                  "reduced_rates": [
                    7
                  ],
                  "disclaimer": "Rates are state/country base rates as of 2026-09; local surcharges and category-specific rates may apply. Verify before relying on them for tax filings."
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}