Skip to main content
FR DE IT EN
Brokers’ area

Guide

SwissRETS: the Swiss standard for exchanging property listings

Updated on 12 November 2026

In brief

SwissRETS is the open format in which Swiss real estate software describes the properties to publish: address, price, areas, texts in several languages, photos. It is maintained by Qualipool, an association of software providers and portals, and published freely on GitHub. Two versions coexist: JSON, which keeps evolving (3.6 today), and XML, frozen at 2.7.

What it is for

A broker enters their properties only once, in their management software. The software exports them in SwissRETS, and each portal reads that same document. Nothing is re-entered, and a change in the software shows up everywhere.

What a SwissRETS document contains

  • The agency’s complete inventory: every property online, at every export.
  • For each property: type and category (99 categories, from apartment to parking space), address and coordinates, price (sale, net rent, service charges, gross rent, per square metre or per period), areas, rooms, floor, year of construction, features, availability.
  • The texts (title, description, location) in each language published, with the photos, floor plans and documents.
  • Projects: a development and its units.
  • The contact: the agency, the broker, the address for receiving enquiries.

JSON or XML?

JSON (version 3.x) is the one that evolves. New features only arrive there, and Qualipool recommends it to those starting out. XML is frozen at version 2.7 and maintained without new features, but many software packages still export it. Both describe the same properties.

And IDX 3.01?

IDX 3.01 is the older format, which some software still exports, often by placing files on a server. Its specification is not public and its fields stopped evolving long ago: SwissRETS is its successor.

How ImmGate uses it

ImmGate reads SwissRETS in JSON as well as XML, whether your software publishes the document at an address or sends it to us. Every field of the standard is read, or left out for a written reason. A test checks this at every change.

The documentation: connecting your software

Sources