GET /v1/properties/{id}

Canonical property record — amenities, reviews, OTA coverage, dedup metadata.

Static property record. Use this for product pages, post-decision detail views, or to inspect amenities and OTA coverage. No idempotency key (read-only).

Endpoint

GET /v1/properties/{property_id}

Parameters

Parameter	Type	Description
`property_id` *	path	From `/decide` or `/search/stays`. Prefix `prop_`.
`include`	query	Comma-separated subset of `signals`, `reviews_aggregate`, `ota_coverage`.

* required

Request

curl https://api.b2a.bluepillow.com/v1/properties/prop_abc123 \
  -H "Authorization: Bearer $B2A_API_KEY"

Response 200

{
  "id": "prop_abc123",
  "name": "Hotel Blue Sky",
  "brand": "Rocco Forte",
  "property_type": "hotel",
  "rating": 4.7,
  "stars": 5,
  "location": {
    "lat": 41.9097, "lon": 12.4801,
    "address": "Via del Babuino 9",
    "city": "Rome", "country": "IT",
    "neighborhood": "Centro Storico"
  },
  "amenities": ["wifi", "spa", "restaurant", "bar", "breakfast"],
  "images": [{"url": "https://...", "caption": "Lobby"}],
  "reviews_aggregate": {
    "score_0_5": 4.7,
    "count": 1843,
    "distribution_by_ota": {"Booking": {"score": 4.7, "count": 1240}}
  },
  "ota_coverage": ["Booking", "Expedia", "Agoda"],
  "dedup_meta": {"source_listings": 4, "confidence": 0.98, "last_reconciled": "2026-05-27T..."}
}

Errors

401 authentication_failed · 404 not_found · 429 rate_limited