Zügle

Finds Swiss municipalities by name fragment or postcode. Returns the BFS id, name, canton and postcodes for each match. The BFS id is the key every other tool here takes.

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Name fragment, e.g. \"Uster\". Case-insensitive.",
      "type": "string",
      "maxLength": 60
    },
    "zip": {
      "description": "Four-digit Swiss postcode, e.g. \"8308\" (which alone spans three Gemeinden).",
      "type": "string",
      "maxLength": 4
    },
    "limit": {
      "description": "Maximum matches to return (1-50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [],
  "additionalProperties": false
}

Calculates the annual Swiss income tax for one municipality and one household profile, split into federal, cantonal and municipal parts. The figures come from the federal tax administration's calculation for the given gross income.

{
  "type": "object",
  "properties": {
    "bfsId": {
      "description": "Municipality BFS id, from municipality_search.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9999
    },
    "income": {
      "description": "Gross annual household income in CHF.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10000000
    },
    "relationship": {
      "description": "Marital status used for the tariff.",
      "type": "string",
      "enum": [
        "single",
        "married"
      ],
      "default": "single"
    },
    "confession": {
      "description": "Church-tax affiliation.",
      "type": "string",
      "enum": [
        "none",
        "roman",
        "protestant"
      ],
      "default": "none"
    },
    "children": {
      "description": "Number of dependent children.",
      "type": "integer",
      "minimum": 0,
      "maximum": 20,
      "default": 0
    },
    "year": {
      "description": "Tax year. Defaults to the year this installation is configured for.",
      "type": "integer",
      "minimum": 2015,
      "maximum": 2025
    }
  },
  "required": [
    "bfsId",
    "income"
  ],
  "additionalProperties": false
}

Returns the tax picture for one municipality relative to a stated current home: the annual difference, the tax multiplier, and the multi-year trend where past years are known.

{
  "type": "object",
  "properties": {
    "bfsId": {
      "description": "The municipality to describe.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9999
    },
    "currentBfsId": {
      "description": "BFS id of the current home, which every difference is measured against.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9999
    },
    "income": {
      "description": "Gross annual income in CHF.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10000000
    },
    "relationship": {
      "description": "Marital status.",
      "type": "string",
      "enum": [
        "single",
        "married"
      ],
      "default": "single"
    },
    "confession": {
      "description": "Church-tax affiliation.",
      "type": "string",
      "enum": [
        "none",
        "roman",
        "protestant"
      ],
      "default": "none"
    },
    "children": {
      "description": "Dependent children.",
      "type": "integer",
      "minimum": 0,
      "maximum": 20,
      "default": 0
    },
    "years": {
      "description": "How many years of history to include.",
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "default": 5
    }
  },
  "required": [
    "bfsId",
    "currentBfsId",
    "income"
  ],
  "additionalProperties": false
}

Ranks municipalities that are cheaper than, or within CHF 1000/yr of, a stated current home, by annual tax saving — municipalities near-identical in cost are included deliberately, not filtered out. Answered from cached figures only, so the ranking may be partial; the response states how many candidates were covered. Pass `near` (a town or station name) and `radiusKm` to keep only places around where the household lives or works; an unrecognised place is reported, not silently ignored.

{
  "type": "object",
  "properties": {
    "currentBfsId": {
      "description": "BFS id of the current home.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9999
    },
    "income": {
      "description": "Gross annual income in CHF.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10000000
    },
    "relationship": {
      "description": "Marital status.",
      "type": "string",
      "enum": [
        "single",
        "married"
      ],
      "default": "single"
    },
    "confession": {
      "description": "Church-tax affiliation.",
      "type": "string",
      "enum": [
        "none",
        "roman",
        "protestant"
      ],
      "default": "none"
    },
    "children": {
      "description": "Dependent children.",
      "type": "integer",
      "minimum": 0,
      "maximum": 20,
      "default": 0
    },
    "currentRooms": {
      "description": "Size of the current home in rooms, used for the rent comparison.",
      "type": "number",
      "minimum": 1,
      "maximum": 20
    },
    "near": {
      "description": "Town or station name to search around, e.g. \"Winterthur\". Not a postcode.",
      "type": "string",
      "maxLength": 80
    },
    "radiusKm": {
      "description": "Distance from `near` in km (default 20). Ignored without `near`.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "currentBfsId",
    "income"
  ],
  "additionalProperties": false
}

Lists apartments currently advertised in one municipality, cheapest first, with the local median asking rent. Indicative figures for browsing only: they come from a portal feed and are not verified against the listing page.

{
  "type": "object",
  "properties": {
    "bfsId": {
      "description": "Municipality to search in.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9999
    },
    "rooms": {
      "description": "Preferred size in rooms; re-ranks, never filters.",
      "type": "number",
      "minimum": 1,
      "maximum": 20
    },
    "surface": {
      "description": "Preferred living space in m²; re-ranks.",
      "type": "number",
      "minimum": 5,
      "maximum": 1000
    },
    "limit": {
      "description": "Maximum listings to return (1-25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  },
  "required": [
    "bfsId"
  ],
  "additionalProperties": false
}

Returns the public-transport journey time in minutes between two Swiss places, using the national timetable.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Origin as a place or station name, e.g. \"Uster\". Not a postcode on its own.",
      "type": "string",
      "maxLength": 80
    },
    "to": {
      "description": "Destination as a place or station name.",
      "type": "string",
      "maxLength": 80,
      "default": "Zürich HB"
    }
  },
  "required": [
    "from"
  ],
  "additionalProperties": false
}

Estimates the monthly cost in CHF of commuting between two Swiss places, as a transit-pass estimate priced from Swiss regional fare-zone data. Some pricing regimes are approximations rather than an exact tariff.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Origin as a place or station name, e.g. \"Feusisberg\". Not a postcode on its own.",
      "type": "string",
      "maxLength": 80
    },
    "to": {
      "description": "Destination as a place or station name.",
      "type": "string",
      "maxLength": 80,
      "default": "Zürich HB"
    }
  },
  "required": [
    "from"
  ],
  "additionalProperties": false
}

Reports the Swiss Federal Statistical Office's average monthly rent for a municipality, optionally for a given apartment size in rooms. BFS does not publish rent below canton level except for 10 named cities, so the figure may describe the CANTON rather than the municipality itself; the response states which.

{
  "type": "object",
  "properties": {
    "bfsId": {
      "description": "Municipality BFS id, from municipality_search.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9999
    },
    "rooms": {
      "description": "Apartment size in rooms, e.g. 3.5. Omit for the overall average.",
      "type": "number",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "bfsId"
  ],
  "additionalProperties": false
}