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: json

Values: 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: json

Values: 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

Example

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.country("de");
console.log(result);
Example response (excerpt)Paid plan

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: json

Values: 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

Example

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.postal("28202", { country: "US" });
console.log(result);
Example response (excerpt)Paid plan

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