DevsDevelopers
Accommodations

Retrieve an accommodation

GET
/accommodations/{product_id}

Returns a single accommodation by its ID. variants is a linked reference — fetch the full variants at its url. Any API key (app-installation-scoped or dashboard-user-scoped) can read any accommodation within the company.

Path Parameters

product_id*string

Product ID of the accommodation type (e.g. acc_9fKbV3aQx7).

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/accommodations/string" \  -H "Easol-API-Version: 2026-11-01"
{
  "object": "accommodation",
  "id": "string",
  "name": "string",
  "tagline": "string",
  "overview": "string",
  "star_rating": 1,
  "entire_property": true,
  "enquire_only": true,
  "required_start_date": "2019-08-24",
  "required_end_date": "2019-08-24",
  "hero_image_url": "http://example.com",
  "overview_image_url": "http://example.com",
  "gallery_image_urls": [
    "http://example.com"
  ],
  "location": {
    "business_name": "string",
    "line_one": "string",
    "line_two": "string",
    "city": "string",
    "post_code": "string",
    "country_code": "string",
    "subdivision_code": "string"
  },
  "slug": "string",
  "dashboard_url": "../dictionary",
  "state": "draft",
  "created_by_app_installation": "string",
  "variants": {
    "object": "list",
    "url": "string",
    "has_more": true,
    "next_cursor": "string",
    "data": [
      {
        "object": "accommodation_variant",
        "id": "string",
        "name": "string",
        "tagline": "string",
        "min_occupancy": 1,
        "max_occupancy": 1,
        "hidden": true,
        "position": 0,
        "checkout_limit": 1,
        "stock_strategy": "inventory",
        "image_url": "http://example.com",
        "price": {
          "amount": 0,
          "currency": "string"
        },
        "accommodation": "string"
      }
    ]
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Create an accommodation POST

Previous Page

Availability

Check whether a product can be booked for a given date, time, party size, and quantity before you create a booking. Availability is served from a precomputed cache, not computed live on each request — recent bookings and stock changes can lag. A 422 at booking time is the source of truth.