Get featured listings

GET

listings

featured

curl --request GET \
  --url https://api.letsway.com/v3/listings/featured \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.letsway.com/v3/listings/featured', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "advertisedPrice": 10,
      "bookingAvailabilityMode": null,
      "category": null,
      "eventDates": null,
      "experienceId": null,
      "hidePrice": false,
      "hostedBy": null,
      "id": "40aec576-8993-490e-bc92-04ec38837c61",
      "isExclusive": false,
      "isUnlisted": false,
      "kind": "resource",
      "maxParticipants": 1,
      "medias": [
        {
          "id": "24e3c523-dcd9-49f8-8e1e-b98d798233b0",
          "kind": "cover",
          "type": "image",
          "links": [
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "384"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "480"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "640"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "750"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "1080"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            }
          ],
          "altText": null
        }
      ],
      "order": 1,
      "pointsEligible": null,
      "pricePerType": "thrid",
      "productLine": "reserve",
      "rating": null,
      "resourceGroupCollectionId": "9ce5652d-991b-4bd8-b8a9-d0d6ad26a974",
      "slug": null,
      "startingPrice": 10,
      "summary": "Indulge in luxury with our Adult Cabana and Daybed, offering private relaxation, personal butler service, and plush comfort in a serene, sophisticated setting.",
      "title": "Cabanas & Daybeds",
      "vibes": []
    },
    {
      "advertisedPrice": 400,
      "bookingAvailabilityMode": null,
      "category": null,
      "eventDates": null,
      "experienceId": null,
      "hidePrice": false,
      "hostedBy": null,
      "id": "778909d7-2d88-4eda-878e-8b7f4777e255",
      "isExclusive": false,
      "isUnlisted": false,
      "kind": "resource",
      "maxParticipants": 1,
      "medias": [
        {
          "id": "2e29bccf-8b3d-4f10-bcf0-f97c79a098fa",
          "kind": "cover",
          "type": "image",
          "links": [
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "384"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "480"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "640"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "750"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "1080"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            }
          ],
          "altText": null
        }
      ],
      "order": 2,
      "pointsEligible": null,
      "pricePerType": "adult cabana",
      "productLine": "reserve",
      "rating": null,
      "resourceGroupCollectionId": "e881831a-92a6-44d0-84cf-523a5986c030",
      "slug": null,
      "startingPrice": 400,
      "summary": "A morning yoga session on the ocean terrace.",
      "title": "Garden View Room",
      "vibes": []
    }
  ]
}

Authorizations

Authorization

string

header

required

Your brand's secret API key, e.g. Bearer way_sk_live_bhEqcn0i1fRoUEHBPjJkQA. The key names the brand, so a brandId in the path must be your own brand. Older Way-Brand-Id + Way-Secret-Key credentials still work: see Legacy authentication.

Headers

Way-Brand-Id

string<uuid>

The brand to scope the response to. Required with an organization key. Ignored with a brand key, which already names its brand.

Query Parameters

isUnlisted

default:false

Set to true to return unlisted listings instead of publicly listed ones.

language

string

Locale for translated content; defaults to the brand's language.

version

enum<string>

default:published

Which content version to return: the published version (default) or the latest draft.

Available options:

latest,

published

Response

200 - application/json

string<uuid>

required

Example:

"40aec576-8993-490e-bc92-04ec38837c61"

isExclusive

boolean

required

Example:

false

isUnlisted

boolean

required

Example:

false

kind

enum<string>

required

Available options:

experience,

resource,

event,

auction

Example:

"resource"

medias

object[]

required

Show child attributes

productLine

enum<string>

required

Available options:

activate,

host,

reserve

Example:

"reserve"

vibes

object[]

required

Show child attributes

advertisedPrice

number | null

Example:

10

bookingAvailabilityMode

enum<string> | null

Available options:

private,

group,

non-restricted

category

object | null

Show child attributes

eventDates

string<date-time>[] | null

experienceId

string<uuid> | null

hidePrice

boolean | null

Example:

false

hostedBy

object | null

Show child attributes

maxParticipants

number | null

Example:

1

order

number | null

Example:

1

pointsEligible

object | null

Show child attributes

pricePerType

string | null

Example:

"thrid"

rating

number | null

resourceGroupCollectionId

string<uuid> | null

Example:

"9ce5652d-991b-4bd8-b8a9-d0d6ad26a974"

slug

string | null

startingPrice

number | null

Example:

10

summary

string | null

Example:

"Indulge in luxury with our Adult Cabana and Daybed, offering private relaxation, personal butler service, and plush comfort in a serene, sophisticated setting."

title

string | null

Example:

"Cabanas & Daybeds"

⌘I

Get featured listings

curl --request GET \
  --url https://api.letsway.com/v3/listings/featured \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.letsway.com/v3/listings/featured', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "advertisedPrice": 10,
      "bookingAvailabilityMode": null,
      "category": null,
      "eventDates": null,
      "experienceId": null,
      "hidePrice": false,
      "hostedBy": null,
      "id": "40aec576-8993-490e-bc92-04ec38837c61",
      "isExclusive": false,
      "isUnlisted": false,
      "kind": "resource",
      "maxParticipants": 1,
      "medias": [
        {
          "id": "24e3c523-dcd9-49f8-8e1e-b98d798233b0",
          "kind": "cover",
          "type": "image",
          "links": [
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "384"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "480"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "640"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "750"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "1080"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            }
          ],
          "altText": null
        }
      ],
      "order": 1,
      "pointsEligible": null,
      "pricePerType": "thrid",
      "productLine": "reserve",
      "rating": null,
      "resourceGroupCollectionId": "9ce5652d-991b-4bd8-b8a9-d0d6ad26a974",
      "slug": null,
      "startingPrice": 10,
      "summary": "Indulge in luxury with our Adult Cabana and Daybed, offering private relaxation, personal butler service, and plush comfort in a serene, sophisticated setting.",
      "title": "Cabanas & Daybeds",
      "vibes": []
    },
    {
      "advertisedPrice": 400,
      "bookingAvailabilityMode": null,
      "category": null,
      "eventDates": null,
      "experienceId": null,
      "hidePrice": false,
      "hostedBy": null,
      "id": "778909d7-2d88-4eda-878e-8b7f4777e255",
      "isExclusive": false,
      "isUnlisted": false,
      "kind": "resource",
      "maxParticipants": 1,
      "medias": [
        {
          "id": "2e29bccf-8b3d-4f10-bcf0-f97c79a098fa",
          "kind": "cover",
          "type": "image",
          "links": [
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "384"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "480"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "640"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "750"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "1080"
            },
            {
              "type": "image",
              "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
              "resolution": "original"
            }
          ],
          "altText": null
        }
      ],
      "order": 2,
      "pointsEligible": null,
      "pricePerType": "adult cabana",
      "productLine": "reserve",
      "rating": null,
      "resourceGroupCollectionId": "e881831a-92a6-44d0-84cf-523a5986c030",
      "slug": null,
      "startingPrice": 400,
      "summary": "A morning yoga session on the ocean terrace.",
      "title": "Garden View Room",
      "vibes": []
    }
  ]
}

Getting started

Listings

Availability

Carts & Checkout

Bookings

Experiences

Brand Configuration

Waitlists

Integrations

Organizations

Get featured listings

Authorizations

Headers

Query Parameters

Response