Listings

List every published listing

GET /api/v1/listings

The full set of published properties for the credentials’ organisation, sorted by nickname. It is neither paginated nor a delta. If you mirror it, delete rows the response no longer contains, so an unpublished listing leaves your site.

Response

200 { listings: Listing[] }

Listing fields

Field	Type	Description
id	string	Opaque. The same id a reservation’s `propertyId` carries.
slug	string
nickname	string	The operator’s short name for the flat.
active	boolean	Always true. Only listed properties are served, and a listed property is in operation.
isListed	boolean	Always true. A property taken off the website disappears from this list.
propertyType	string	Apartment, House, … as the operator classified it.
roomType	string	Entire home/apt, Private room, …
address	Address
accommodates	integer	How many people the flat sleeps.
rooms	Room[]
bedrooms	integer	Derived from `rooms`.
beds	integer	Derived from `rooms`.
bathrooms	number	Derived from `rooms`. Fractional for half bathrooms.
squareMeter	integer \| null
timezone	string	The IANA zone the listing’s dates are local to.
pricing	object
currency	"EUR"
rateBasis	enum	Which of `monthlyRateCents` or `nightlyRateCents` this listing charges. The other keeps whatever the operator set and is never converted. "monthly""nightly"
monthlyRateCents	integer \| null	Monthly rent. Integer euro-cents.
nightlyRateCents	integer \| null	The nightly rate. Integer euro-cents.
depositCents	integer \| null	Security deposit. Integer euro-cents.
utilitiesCents	integer \| null	Monthly utilities. Integer euro-cents.
furnitureCents	integer \| null	Monthly furniture fee. Integer euro-cents.
terms	object
minNights	integer \| null	The shortest stay the operator accepts.
maxNights	integer \| null
amenities	string[]	Amenity keys, e.g. wifi, washer, dishwasher.
description	Description
translations	map of Description	The same six fields per site language, keyed by language code. Fall back to `description` for anything missing.
images	Image[]	Sorted by `sortOrder`. The primary photo is not necessarily first.
publishedAt	timestamp	When the Publish button froze this content. ISO 8601

Notes

description fields are HTML from the editor; title is plain. Fall back to description for anything missing from translations.
Money is integer euro-cents; a null price means the operator has not set one. rateBasis says which of monthlyRateCents or nightlyRateCents this listing quotes.

Request

curl "https://go.quarters.live/api/v1/listings" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const res = await fetch("https://go.quarters.live/api/v1/listings", {
  headers: { Authorization: `Bearer ${token}` }
});
const { listings } = await res.json();

import requests

res = requests.get(
    "https://go.quarters.live/api/v1/listings",
    headers={"Authorization": f"Bearer {token}"},
)
res.raise_for_status()
listings = res.json()["listings"]

$ch = curl_init("https://go.quarters.live/api/v1/listings");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer $token"],
]);
$res = curl_exec($ch);
curl_close($ch);
$listings = json_decode($res, true)["listings"];

require "net/http"
require "json"

uri = URI("https://go.quarters.live/api/v1/listings")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{token}"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
listings = JSON.parse(res.body)["listings"]

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	token := os.Getenv("ACCESS_TOKEN")
	req, _ := http.NewRequest("GET", "https://go.quarters.live/api/v1/listings", nil)
	req.Header.Set("Authorization", "Bearer "+token)
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var data map[string]any
	json.NewDecoder(res.Body).Decode(&data)
	fmt.Println(data["listings"])
}

Response · 200

{
  "listings": [
    {
      "id": "0d6e1c2a-…",
      "slug": "jordaan-canal-loft",
      "nickname": "JOR-1A",
      "active": true,
      "isListed": true,
      "propertyType": "Apartment",
      "roomType": "Entire home/apt",
      "address": {
        "street": "Prinsengracht 123",
        "postalCode": "1015 DX",
        "city": "Amsterdam",
        "country": "NL",
        "area": "Jordaan",
        "latitude": 52.3731,
        "longitude": 4.8837
      },
      "accommodates": 2,
      "rooms": [
        {
          "kind": "bedroom",
          "name": "",
          "beds": [
            {
              "type": "queen",
              "count": 1
            }
          ]
        },
        {
          "kind": "full_bathroom",
          "name": "",
          "beds": []
        }
      ],
      "bedrooms": 1,
      "beds": 1,
      "bathrooms": 1,
      "squareMeter": 58,
      "timezone": "Europe/Amsterdam",
      "pricing": {
        "currency": "EUR",
        "rateBasis": "monthly",
        "monthlyRateCents": 240000,
        "nightlyRateCents": null,
        "depositCents": 240000,
        "utilitiesCents": 15000,
        "furnitureCents": null
      },
      "terms": {
        "minNights": 30,
        "maxNights": 365
      },
      "amenities": [
        "wifi",
        "washer",
        "dishwasher"
      ],
      "description": {
        "title": "Canal loft in the Jordaan",
        "summary": "<p>…</p>",
        "space": "<p>…</p>",
        "neighborhood": "<p>…</p>",
        "access": null,
        "notes": null
      },
      "translations": {
        "nl": {
          "title": "…",
          "summary": "<p>…</p>",
          "space": null,
          "neighborhood": null,
          "access": null,
          "notes": null
        }
      },
      "images": [
        {
          "id": "4b7a…",
          "isPrimary": true,
          "caption": null,
          "sortOrder": 0,
          "width": 2400,
          "height": 1600,
          "bytes": 481221,
          "thumbnail": "https://…",
          "regular": "https://…",
          "large": "https://…",
          "original": "https://…"
        }
      ],
      "publishedAt": "2026-08-28T09:12:44.000Z"
    }
  ]
}