List all accommodations

GET
/accommodations

Lists accommodations. Each entry has the same shape as GET /accommodations/{id}, including the variants relationship.

Results are ordered by creation time, newest first, and paginated with an opaque cursor in next_cursor; pass it back as next_cursor on the next call to fetch the next page (null means there are no more results). Malformed cursors are ignored and the first page is returned.

Both published and draft accommodations are returned; archived accommodations are excluded.

All API keys (app-installation-scoped and dashboard-user-scoped) see every non-archived accommodation in the company.

Query Parameters

limit?integer

Number of results per page. Default 50, maximum 200. Values above 200 or zero/negative are clamped to that range rather than rejected.

Default50
next_cursor?string

Opaque pagination cursor returned in next_cursor of the previous response. Malformed values are ignored and the first page is returned.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/accommodations" \  -H "Easol-API-Version: 2026-11-01"
{
  "object": "string",
  "url": "string",
  "has_more": true,
  "next_cursor": "string",
  "data": [
    {
      "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"
  }
}