Listings

Retrieve live availability

GET /api/v1/listings/{id}/calendar

Per-day availability, computed on request from reservations and calendar blocks. The one read not bound to a snapshot, so a booking made thirty seconds ago already shows.

Path parameters

Parameter	In	Type	Description
id required	path	string	The listing id. It must be published.

Query parameters

Parameter	In	Type	Description
start	query	date	Defaults to today in the listing’s timezone. YYYY-MM-DD
end	query	date	Inclusive. Defaults to start + 730 days. The range may span at most 1100 days. YYYY-MM-DD

Response

200 { days: CalendarDay[] }

CalendarDay fields

Field	Type	Description
date	date	YYYY-MM-DD
status	enum	`booked` is a confirmed tenancy; `reserved` is held but not yet firm; `unavailable` is a calendar block such as a renovation; `available` is bookable. "available""reserved""booked""unavailable"
minNights	integer	The listing’s base minimum.
isBaseMinNights	boolean	Always true.

Errors

Every failure is { error, message }; see Errors. A missing or expired bearer is a 401 on every endpoint but the token exchange.

Status	error	When
400	invalid_request	A date that is not YYYY-MM-DD, end before start, or a span over 1100 days.
404	not_found	Unknown or unpublished listing.

Notes

Inquiries and options never block a day. Cancelling releases the days immediately.
A tenancy’s end date is exclusive. One ending on the 30th leaves the 30th available.

Request

curl "https://go.quarters.live/api/v1/listings/0d6e1c2a-…/calendar?start=2026-10-01&end=2026-10-04" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const res = await fetch("https://go.quarters.live/api/v1/listings/0d6e1c2a-…/calendar?start=2026-10-01&end=2026-10-04", {
  headers: { Authorization: `Bearer ${token}` }
});
const { days } = await res.json();

import requests

res = requests.get(
    "https://go.quarters.live/api/v1/listings/0d6e1c2a-…/calendar",
    params={
      "start": "2026-10-01",
      "end": "2026-10-04",
    },
    headers={"Authorization": f"Bearer {token}"},
)
res.raise_for_status()
days = res.json()["days"]

$ch = curl_init("https://go.quarters.live/api/v1/listings/0d6e1c2a-…/calendar?start=2026-10-01&end=2026-10-04");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer $token"],
]);
$res = curl_exec($ch);
curl_close($ch);
$days = json_decode($res, true)["days"];

require "net/http"
require "json"

uri = URI("https://go.quarters.live/api/v1/listings/0d6e1c2a-…/calendar?start=2026-10-01&end=2026-10-04")
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) }
days = JSON.parse(res.body)["days"]

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/0d6e1c2a-…/calendar?start=2026-10-01&end=2026-10-04", 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["days"])
}

Response · 200

{
  "days": [
    {
      "date": "2026-10-01",
      "status": "booked",
      "minNights": 30,
      "isBaseMinNights": true
    },
    {
      "date": "2026-10-02",
      "status": "reserved",
      "minNights": 30,
      "isBaseMinNights": true
    },
    {
      "date": "2026-10-03",
      "status": "unavailable",
      "minNights": 30,
      "isBaseMinNights": true
    },
    {
      "date": "2026-10-04",
      "status": "available",
      "minNights": 30,
      "isBaseMinNights": true
    }
  ]
}