POST /DomicileList

Returns the list of domiciles based on postal code or place name of the taxable person's residence or company's headquarters. 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 both zip and domicile parameters will result in an HTTP 400 error (Bad Request).

Resource URL

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

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, Tax calculator for Capital gain

Parameters

Either zip or domicile must be provided.

  • 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

  • zip Semi-optional

    Postal code of the taxable person's residence or company's headquarters.Example Value: 8000

  • domicile Semi-optional

    Place of the taxable person's residence or company's headquarters. A partial name of the client's residence or company's headquarters can be provided.Example Value: Wiedikon

Example Request

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

{
  "zip": 8000,
  "domicile": "Wi"
}

Example Result

{
  "data": {
    "id": "f38f8c72-34bb-4c7b-940a-8ef8dac52f9c",
    "request-date-time": "2015-08-18T11:53:35.753+0200",
    "attributes": {
      "domiciles": [{
        "zip": "8000",
        "name": "Alt Wiedikon (Kr.03/1)"
      },
      {
        "zip": "8000",
        "name": "Wiedikon (Zürich Kr. 3)"
      },
      {
        "zip": "8000",
        "name": "Wipkingen (Kr.10/2)"
      },
      {
        "zip": "8000",
        "name": "Witikon (Kr.07/4)"
      }]
    },
    "type": "domicile-list"
  }
}