--- title: VAT Rates by Country API Reference version: 1.0.0 description: Get VAT rates for a specific country including standard, reduced, and super-reduced rates. Covers all EU and major global jurisdictions. openapi: 3.1.1 servers: - https://api.apifreaks.com/v1.0 paths: 1 operations: 1 schemas: 5 --- ## Table of Contents - [VAT Rates by Country API Reference v1.0.0](#vat-rates-by-country-api-reference-v100) - [Authentication](#authentication) - [Financial APIs](#financial-apis) - [getVatRatesByCountry](#getvatratesbycountry) - [Parameters](#parameters) - [Responses](#responses) - [Schemas](#schemas) - [VatCountryResponse](#vatcountryresponse) - [VatRateItem](#vatrateitem) - [VatRateDecimal](#vatratedecimal) - [VatCategories](#vatcategories) - [ErrorResponse](#errorresponse) # VAT Rates by Country API Reference v1.0.0 Get VAT rates for a specific country including standard, reduced, and super-reduced rates. Covers all EU and major global jurisdictions. Base URLs: * [https://api.apifreaks.com/v1.0](https://api.apifreaks.com/v1.0) ## Authentication * API Key (ApiKeyAuthHeader) - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header. * API Key (ApiKeyAuthQuery) - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter. ## Financial APIs ### getVatRatesByCountry `GET /vat/rates/country` *Get VAT rate by country code* Fetches VAT rates for a single country or state provided via query parameters. #### Parameters |Name|In|Type|Required|Description| |---|---|---|---|---| |format|query|string|false|Specify the desired response format. Options: 'json' (default) or 'xml'.| |country|query|string|true|Country identifier in Alpha-2 (PK), Alpha-3 (PAK), or full name (Pakistan). Combine with the optional "state" query for sub-national VAT; values are case-insensitive and may use underscores instead of spaces.| |state|query|string|false|Optional state or region in Alpha-2 (NY) or full name (New_York). Use with "country" for state-level VAT; values are case-insensitive and may use underscores.| ##### Enumerated Values |Parameter|Value| |---|---| |format|json| |format|xml| > Example responses > Successful response with a JSON array containing VAT rate objects for the requested country or state. ```json [ { "country": "DE", "type": "vat", "currency": "EUR", "standard_rate": 0.19, "reduced_rate": [ 0.07, 0 ], "categories": { "books": 0.07, "newspapers": 0.07, "periodicals": 0.07, "broadcasting": 0 } } ] ``` ```json [ { "country": "US", "state": "NY", "type": "vat", "currency": "", "standard_rate": 0.04 } ] ``` > Bad Request — Missing required country parameter ```json { "error": "Invalid Param Exception", "message": "please pass correct parameters", "path": "/v1.0/vat/rates/country", "status": 400, "timestamp": "2026-07-27T11:45:34.183Z" } ``` > Not Found — No VAT data for the given country/state ```json { "message": "No VAT data found." } ``` #### Responses |Status|Meaning|Description|Schema| |---|---|---|---| |200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful response with a JSON array containing VAT rate objects for the requested country or state.|[VatCountryResponse](#vatcountryresponse)| |400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|Bad Request — Missing required country parameter|[ErrorResponse](#errorresponse)| |404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found — No VAT data for the given country/state|[ErrorResponse](#errorresponse)| #### Response Headers |Status|Header|Type|Format|Description| |---|---|---|---|---| |200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.| |400|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.| |404|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.| To perform this operation, you must be authenticated by means of one of the following methods: ApiKeyAuthHeader, ApiKeyAuthQuery ## Schemas ### VatCountryResponse Array of VAT rate objects for the requested country or state. #### Properties |Name|Type|Required|Restrictions|Description| |---|---|---|---|---| |*anonymous*|[[VatRateItem](#vatrateitem)]|false|none|Array of VAT rate objects for the requested country or state.| ### VatRateItem Each item in the array represents a VAT rate object for the requested country or state. #### Properties |Name|Type|Required|Restrictions|Description| |---|---|---|---|---| |country|string|true|none|Country identifier returned by the API.| |state|string|false|none|State or region identifier for sub-national tax data.| |type|string|true|none|Tax type for the location (e.g., vat or none).| |currency|string|true|none|ISO 4217 currency code for the country or state.| |standard_rate|number(float)|true|none|Standard VAT or sales tax rate as a decimal (e.g., 0.19 = 19%).| |reduced_rate|[[VatRateDecimal](#vatratedecimal)]|false|none|Reduced VAT rates when the country defines them (EU/UK only).| |super_reduced_rate|[[VatRateDecimal](#vatratedecimal)]|false|none|Super-reduced VAT rates for eligible categories (EU/UK only).| |parking_rate|number(float)|false|none|Parking rate where defined (EU/UK only).| |categories|[VatCategories](#vatcategories)|false|none|Category-specific VAT rates, where defined (EU/UK only). Keys vary by country - not every category below applies to every country.| ### VatRateDecimal A VAT rate expressed as a decimal (e.g., 0.19 = 19%). #### Properties |Name|Type|Required|Restrictions|Description| |---|---|---|---|---| |*anonymous*|number(float)|false|none|A VAT rate expressed as a decimal (e.g., 0.19 = 19%).| ### VatCategories Category-specific VAT rates, where defined (EU/UK only). Keys vary by country. #### Properties |Name|Type|Required|Restrictions|Description| |---|---|---|---|---| |books|number(float)|false|none|VAT rate for books, as a decimal (e.g., 0.07 = 7%).| |newspapers|number(float)|false|none|VAT rate for newspapers, as a decimal (e.g., 0.07 = 7%).| |periodicals|number(float)|false|none|VAT rate for periodicals, as a decimal (e.g., 0.07 = 7%).| |broadcasting|number(float)|false|none|VAT rate for broadcasting services, as a decimal (e.g., 0.19 = 19%).| ### ErrorResponse Standard error envelope returned by the API on failed requests. #### Properties |Name|Type|Required|Restrictions|Description| |---|---|---|---|---| |error|string|false|none|Short error category or exception type.| |message|string|true|none|Human-readable error message describing the failure.| |path|string|false|none|API endpoint path that produced the error.| |status|integer|false|none|HTTP status code returned with the error.| |timestamp|string(date-time)|false|none|Timestamp when the error occurred (ISO 8601).|