TaxJurisdiction

Geographic tax jurisdiction with hierarchical structure. Represents countries, states, provinces, cities, or postal code zones with their tax authority information.

7 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
codestring
stored

Unique jurisdiction code (ISO country, state code, city code)

Example: "FR-75"

Required
namestring
stored

Name of the jurisdiction

Example: "Paris"

Required
levelstring
enum

Level of jurisdiction

Values: federal, country, state, province, city, district, postal_code

Example: "city"

Required
parentJurisdictionTaxJurisdiction
stored

Parent jurisdiction for hierarchical structure (e.g., Paris → Île-de-France → France)

Optional
countryCodestring
stored

ISO 3166-1 alpha-2 country code

Example: "FR"

Required
taxAuthorityNamestring
stored

Name of the tax authority for this jurisdiction

Example: "Direction Générale des Finances Publiques (DGFiP)"

Optional
taxAuthorityWebsitestring
stored

Official website of the tax authority

Example: "https://www.impots.gouv.fr"

Optional

Examples

Example 1

{
  "@type": "TaxJurisdiction",
  "code": "FR-75",
  "name": "Paris",
  "level": "city",
  "parentJurisdiction": {
    "@type": "TaxJurisdiction",
    "code": "FR-IDF"
  },
  "countryCode": "FR",
  "taxAuthorityName": "Direction Générale des Finances Publiques (DGFiP)",
  "taxAuthorityWebsite": "https://www.impots.gouv.fr"
}

Example 2

{
  "@type": "TaxJurisdiction",
  "code": "US-NY",
  "name": "New York",
  "level": "state",
  "parentJurisdiction": {
    "@type": "TaxJurisdiction",
    "code": "US"
  },
  "countryCode": "US",
  "taxAuthorityName": "New York State Department of Taxation and Finance",
  "taxAuthorityWebsite": "https://www.tax.ny.gov"
}

Example 3

{
  "@type": "TaxJurisdiction",
  "code": "CA-ON",
  "name": "Ontario",
  "level": "province",
  "parentJurisdiction": {
    "@type": "TaxJurisdiction",
    "code": "CA"
  },
  "countryCode": "CA",
  "taxAuthorityName": "Canada Revenue Agency (CRA)",
  "taxAuthorityWebsite": "https://www.canada.ca/en/revenue-agency.html"
}