POST /TaxCommunityList

Returns the list of tax communities for a particular canton of Switzerland. Returns a string describing the failure condition when unsuccessful.

Sending an empty request will return an HTTP 415 error (Unsupported Media Type). Failure to provide the canton parameter will result in an HTTP 400 error (Bad Request).

Resource URL

https://api.drtax.ch/TaxCalculator/TaxCommunityList

Resource Information

  • Response formats

    JSON

  • Requires authentication?

    No

  • Rate limited?

    No

  • Used in

    Tax calculator for Natural persons, Tax calculator for Legal persons, Tax calculator for Property gain

Parameters

  • tax-year Optional

    Tax year for which the request is issued. If not provided, a year preeceding the current calendar year will be used.Example Value: 2014

  • canton Required

    Canton of Switzerland for which the list of tax communities is returned. This value corresponds to an index in a list returned by the /CantonList service.Example Values: 0-25

Example Request

POST
https://api.drtax.ch/TaxCalculator/TaxCommunityList

{
  "tax-year": 2014,
  "canton": 11
}

Example Result

{
  "data": {
    "id": "850d6e1b-1f93-4d71-8f4d-3356f7ca4c33",
    "request-date-time": "2015-08-18T12:37:22.831+0200",
    "attributes": {
      "tax-communities": ["Adligenswil",
      "Aesch",
      "Alberswil",
      "Altbüron",
      "Altishofen",
      "Altwis",
      "Ballwil",
      "Beromünster",
      "Buchrain",
      "Buttisholz",
      "Büron",
      "Dagmersellen",
      "Dierikon",
      "Doppleschwand",
      "Ebersecken",
      "Ebikon",
      "Egolzwil",
      "Eich",
      "Emmen",
      "Entlebuch",
      "Ermensee",
      "Eschenbach",
      "Escholzmatt-Marbach",
      "Ettiswil",
      "Fischbach",
      "Flühli",
      "Gettnau",
      "Geuensee",
      "Gisikon",
      "Greppen",
      "Grossdietwil",
      "Grosswangen",
      "Hasle",
      "Hergiswil",
      "Hildisrieden",
      "Hitzkirch",
      "Hochdorf",
      "Hohenrain",
      "Honau",
      "Horw",
      "Inwil",
      "Knutwil",
      "Kriens",
      "Luthern",
      "Luzern",
      "Malters",
      "Mauensee",
      "Meggen",
      "Meierskappel",
      "Menznau",
      "Nebikon",
      "Neuenkirch",
      "Neuenkirch (Hellbühl)",
      "Neuenkirch (Sempach Station)",
      "Nottwil",
      "Oberkirch",
      "Pfaffnau",
      "Pfaffnau-St.Urban",
      "Rain",
      "Reiden",
      "Rickenbach",
      "Roggliswil",
      "Romoos",
      "Root",
      "Rothenburg",
      "Ruswil",
      "Römerswil",
      "Schenkon",
      "Schlierbach",
      "Schongau",
      "Schwarzenberg",
      "Schötz",
      "Schüpfheim",
      "Sempach",
      "Sursee",
      "Triengen",
      "Udligenswil",
      "Ufhusen",
      "Vitznau",
      "Wauwil",
      "Weggis",
      "Werthenstein",
      "Wikon",
      "Willisau",
      "Wolhusen",
      "Zell"]
    },
    "type": "tax-community-list"
  }
}