Tax
Sales tax rates and US property-tax medians in paid place detail.
Tax data belongs to the place you look up. Paid plans automatically include available sales tax reference rates or US property-tax medians. Each place lookup includes its tax references.
Sales taxCopy link
tax.name names the sales tax, VAT, or GST. tax.rate is a percentage: 7.9 means 7.9%. Choose the geographic reference for the task. The combined ZIP rate includes its components.
GET /country/{code}API Explorer ↗Standard national reference rate. US rate is null
Parameters
- codestring · path · required
ISO 3166-1 alpha-2 or alpha-3, or a country name (germany)
- formatstring · query · optional
json by default. geojson returns simplified country land outlines for map display as Polygon/MultiPolygon Features with stable ISO2 IDs. Very small islands and holes may be omitted. Missing outlines retain null geometry; unavailable geometry storage returns 503. Selected country facts and existing Deep access are preserved. API 2.0.0.
Default:
jsonValues:
json, geojson- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
GET /state/{code}API Explorer ↗State or province reference rate
Parameters
- codestring · path · required
State or province code or name (NC, colorado, ontario)
- formatstring · query · optional
json by default. geojson returns simplified administrative Polygon/MultiPolygon outlines with country-qualified IDs and selected facts in properties. Coordinates are longitude first. Missing or ambiguous outlines retain null geometry. Unavailable boundary storage returns 503. Collections retain parent context. Existing Deep access and pooled allowance apply. API 2.0.0 and later.
Default:
jsonValues:
json, geojson- countrystring · query · optional
ISO2, ISO3, or a country name. Optional when the code or name is globally unique. A collision 404s asking for it.
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
GET /postal/{code}?country=USAPI Explorer ↗Combined local reference rate for a US ZIP
Parameters
- codestring · path · required
Postal or ZIP code. Unique codes resolve bare (SW1A 1AA). Use ?country=JP for 100-0001, whose digits also occur in Portugal.
- countrystring · query · optional
ISO2, ISO3, or a country name. Optional when the code exists in exactly one covered country. Both five-digit and seven-digit codes can collide.
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.country("de");
console.log(result);This example shows selected fields or shortened lists. Send the request for the full response.
{
"country": "DE",
"iso_alpha3": "DEU",
"iso_numeric": 276,
"name": "Germany",
"name_full": "Federal Republic of Germany",
"name_local": "Deutschland",
"demonym": "German",
"continent": "EU",
"region": "Europe",
"subregion": "Western Europe",
"currency": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"calling_code": "+49",
"flag": "🇩🇪",
"languages": [
"de"
],
"timezones": [
"Europe/Berlin",
"Europe/Zurich"
],
"borders": [
"AT",
"BE",
"CH",
"CZ",
"DK",
"FR",
"LU",
"NL",
"PL"
],
"blocs": [
"EEA",
"EU",
"EUROZONE",
"G7",
"NATO",
"OECD",
"SCHENGEN",
"SEPA"
],
"capital": {
"name": "Berlin",
"latitude": 52.52,
"longitude": 13.4
},
"population": 83516593,
"gdp_usd": 5050922925047.05,
"gdp_per_capita_usd": 60496.44,
"population_growth_percent": -0.03,
"urban_population_percent": 82.14,
"internet_users_percent": 93.5,
"area": 357021,
"land_area": null,
"water_area": null,
"coastline": 2389,
"elevation_average": 263,
"lowest_point": {
"name": "Neuendorf bei Wilster",
"elevation": -3.5
},
"highest_point": {
"name": "Zugspitze",
"elevation": 2963
},
"tld": ".de",
"week_start": "monday",
"units": "metric",
"driving_side": "right",
"plugs": [
"C",
"F"
],
"voltage": 230,
"frequency": 50,
"emergency": {
"police": "110",
"ambulance": "112",
"fire": "112"
},
"postal_format": "#####",
"postal_regex": "^(?:\\d{5})$",
"tax": {
"name": "VAT",
"rate": 19
},
"ioc": "GER",
"fifa": "GER",
"plate": "D"
}ZIP components are already included in the combined rate. 0 is a known zero for the reported scope; null means unavailable or not applicable. A zero state rate does not mean local taxes are zero. ZIP boundaries can cross tax jurisdictions, so the rate at an exact address can differ. These lookups do not calculate the tax owed on an order or determine filing requirements.
Property taxCopy link
property_tax gives the median annual real-estate tax payable on owner-occupied housing in a US ZIP area or county. annual_median is an amount in USD, adjusted to the final year of its source observation period. Postal serves the current estimate and uses currency. County detail also includes property_tax.currency and property_tax.period; for example, 2020-2024 describes a five-year estimate in 2024 dollars. This is a regional statistic, not a percentage or an individual property bill.
GET /postal/{code}?country=USAPI Explorer ↗Median annual property tax for a US ZIP area
Parameters
- codestring · path · required
Postal or ZIP code. Unique codes resolve bare (SW1A 1AA). Use ?country=JP for 100-0001, whose digits also occur in Portugal.
- countrystring · query · optional
ISO2, ISO3, or a country name. Optional when the code exists in exactly one covered country. Both five-digit and seven-digit codes can collide.
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
GET /county/{code}?country=USAPI Explorer ↗Median annual property tax for a US county; code is the county FIPS code
Parameters
- codestring · path · required
County code or name (08031, guilford county, E09000033)
- formatstring · query · optional
json by default. geojson returns simplified administrative Polygon/MultiPolygon outlines with country-qualified IDs and selected facts in properties. Coordinates are longitude first. Missing or ambiguous outlines retain null geometry. Unavailable boundary storage returns 503. Collections retain parent context. Existing Deep access and pooled allowance apply. API 2.0.0 and later.
Default:
jsonValues:
json, geojson- countrystring · query · optional
ISO2, ISO3, or a country name. Optional when the code or name is unique.
- statestring · query · optional
ADM1 code or name. Narrows name lookups. Prefer louisiana over LA, which collides across countries, or include country=US.
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.postal("28202", { country: "US" });
console.log(result);This example shows selected fields or shortened lists. Send the request for the full response.
{
"postal": "28202",
"city": "Charlotte",
"city_local": null,
"county": "37119",
"county_name": "Mecklenburg",
"county_name_local": null,
"state": "NC",
"state_name": "North Carolina",
"state_name_local": null,
"country": "US",
"country_name": "United States",
"latitude": 35.227271,
"longitude": -80.844194,
"timezone": "America/New_York",
"type": "standard",
"elevation": 245,
"elevation_ft": 804,
"population": 17653,
"area": 4.68,
"land_area": 4.67,
"water_area": 0.01,
"currency": "USD",
"tax": {
"name": "Sales tax",
"rate": 8.25,
"rate_state": 4.75,
"rate_county": 2,
"rate_city": null,
"rate_special": 1.5
},
"property_tax": {
"annual_median": 3346
},
"neighbors": [
"28280",
"28282",
"28244",
"28204",
"28203",
"28206",
"28207",
"28274"
],
"metros": [
{
"code": "16740",
"name": "Charlotte-Concord-Gastonia, NC-SC",
"type": "metropolitan",
"share_percent": 100
}
]
}Estimates cover the 50 states plus DC, with values where a usable estimate is published. Missing, censored, or unsupported estimates return property_tax: null. Compare the same geographic scope and period. Dividing median property tax by median home value does not give a median effective tax rate.
Response fields
- currencyLink to currencystring or null
- Currency for the current Postal property-tax amount; USD for US ZIP estimates. County amounts use property_tax.currency
- tax.nameLink to tax.namestring or null
- Levy name (VAT, GST, Sales tax). Null when unavailable or no levy is named
- tax.rateLink to tax.ratenumber or null
- Reference rate in percent: 7.9 means 7.9%. Country is national, state is the subdivision reference, and ZIP is combined. Do not add geographic scopes
- tax.rate_stateLink to tax.rate_statenumber or null
- ZIP only. State piece of the combined rate, percent. Null when unavailable or not applicable
- tax.rate_countyLink to tax.rate_countynumber or null
- ZIP only. County piece of the combined rate, percent. Null when unavailable or not applicable
- tax.rate_cityLink to tax.rate_citynumber or null
- ZIP only. City piece of the combined rate, percent. Null when unavailable or not applicable
- tax.rate_specialLink to tax.rate_specialnumber or null
- ZIP only. Special district piece of the combined rate, percent. Null when unavailable or not applicable
- property_taxLink to property_taxobject or null
- Median annual real-estate tax payable on owner-occupied housing, in US dollars adjusted to the final year of period. Available US ZIP-area and county estimates only. Not a percentage or an individual property bill. Null when missing, censored or unsupported.
- property_tax.annual_medianLink to property_tax.annual_medianinteger
- Median annual amount in currency. Dollars adjusted to the final year of period
- property_tax.currencyLink to property_tax.currencystring
- USD
- property_tax.periodLink to property_tax.periodstring
- Observation period, such as 2020-2024