Get experience

GET

brands

{brandId}

experiences

{experienceId}

Get experience

curl --request GET \
  --url https://api.letsway.com/v1/brands/{brandId}/experiences/{experienceId} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.letsway.com/v1/brands/{brandId}/experiences/{experienceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.letsway.com/v1/brands/{brandId}/experiences/{experienceId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": {
    "id": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b",
    "title": "Sunset Sailing Tour",
    "slug": "sunset-sailing-tour-a54f004c",
    "headline": "A two-hour coastal cruise with drinks at golden hour.",
    "description": "<p>Set sail along the coast at golden hour - a two-hour cruise with drinks and canapés included.</p>.",
    "vibes": [
      {
        "id": "f047e2cb-1fb5-4374-8f3e-4bfcc6d7284e",
        "name": "Winter"
      },
      {
        "id": "da568b2b-24c4-4b4a-9ac5-7010986368d3",
        "name": "Summer"
      }
    ],
    "category": {
      "id": "c80c38ad-7379-42b0-ae92-bc26de382a0b",
      "name": "Family"
    },
    "location": {
      "id": "0e4e5db1-de94-41f8-9713-5074f9f0645a",
      "longitude": -97.7430608,
      "latitude": 30.267153,
      "name": "Austin, TX, USA",
      "timezoneId": "America/Chicago",
      "additionalInfo": ""
    },
    "maxParticipantsCount": 10,
    "sessionDurationMinutes": 60,
    "currency": "USD",
    "coverPicture": {
      "id": "0a4cd3a1-d099-4916-90ea-7e5012c06598",
      "mimeType": "image/jpeg",
      "uri": {
        "original": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "384w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "480w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "640w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "750w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "1080w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg"
      }
    },
    "pictures": [],
    "medias": [
      {
        "id": "0a4cd3a1-d099-4916-90ea-7e5012c06598",
        "type": "image",
        "kind": "cover",
        "altText": null,
        "links": [
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "original"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "384"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "480"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "640"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "750"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "1080"
          }
        ]
      }
    ],
    "bookingAvailabilityMode": "group",
    "providedItems": [],
    "healthAndSafety": "",
    "isExclusive": false,
    "isBookable": true,
    "isUnlisted": false,
    "type": "recurring",
    "hostedBy": {
      "id": "c7c21aa6-110b-48d9-a970-47658473302a",
      "profilePicture": null,
      "firstName": "Sam",
      "lastName": " ",
      "emailAddress": "alice@example.com",
      "description": null,
      "allowOverlappingBookings": false
    },
    "externalField": null,
    "paymentMethods": [
      "credit-card",
      "room-charge",
      "member-number"
    ],
    "priceTiers": [
      {
        "id": "6c59db13-2c63-43b9-b91b-6267544f5fdb",
        "name": "Participant",
        "price": 100
      }
    ],
    "taxes": [],
    "integrationMeta": [],
    "partySize": null,
    "hidePrice": false,
    "isNoHost": true,
    "isTicketed": false,
    "shouldValidateComplimentaryBooking": {},
    "firstAvailableDate": {
      "scheduledDate": "2026-07-15",
      "sessions": [
        {
          "supportedParticipantsCount": 10,
          "startTime": "10:00:00",
          "duration": 60
        }
      ]
    },
    "descriptionPicture": null,
    "kind": "experience",
    "minimumRequiredToBook": null,
    "maximumAllowedToBook": null,
    "number": null,
    "displayedCapacity": null,
    "shape": null,
    "position": null,
    "resourceGroupId": null,
    "cancellationPolicyId": null,
    "reschedulePolicyId": null,
    "limitedTimeId": null,
    "customCallToAction": null
  }
}

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.

Path Parameters

brandId

string

required

The brand's ID. With a brand key this must be your own brand; with an organization key it can be any brand in the organization.

experienceId

string

required

The experience's ID.

Query Parameters

language

string

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

Response

200 - application/json

Get experience.

string

required

The unique identifier of the experience.

Example:

"exp-123"

title

string

required

The title of the experience.

Example:

"Scuba Diving in Bali"

slug

string

required

The slug for the experience URL.

Example:

"scuba-diving-bali"

headline

string

required

Headline of the experience.

Example:

"Dive into the crystal-clear waters of Bali"

description

string

required

Description of the experience.

Example:

"An exciting scuba diving adventure in Bali"

vibes

object[]

required

Vibes associated with the experience.

Show child attributes

category

object

required

Category of the experience.

Show child attributes

location

object

required

Location details.

Show child attributes

maxParticipantsCount

number

required

Maximum number of participants.

Example:

10

sessionDurationMinutes

number

required

Session duration in minutes.

Example:

120

currency

string

required

Currency of the experience.

Example:

"USD"

coverPicture

object

required

Cover picture of the experience.

Show child attributes

pictures

object[]

required

Additional pictures.

Show child attributes

medias

object[]

required

Media assets.

Show child attributes

bookingAvailabilityMode

string

required

Booking availability mode.

Example:

"instant"

providedItems

string[]

required

Provided items.

Example:

["Diving suit", "Oxygen tank"]

healthAndSafety

string

required

Health and safety measures.

Example:

"Life jacket required"

isExclusive

boolean

required

Indicates if the experience is exclusive.

Example:

true

isBookable

boolean

required

Indicates if the experience is bookable.

Example:

true

isUnlisted

boolean

required

Indicates if the experience is unlisted.

Example:

false

type

string

required

Type of the experience.

Example:

"adventure"

hostedBy

object

required

Host of the experience.

Show child attributes

paymentMethods

string[]

required

Available payment methods.

Example:

["credit-card", "cash"]

priceTiers

string[]

required

Available price tiers.

Example:

[{ "name": "Standard", "price": 50 }]

taxes

string[]

required

Taxes applied to the experience.

Example:

[{ "name": "VAT", "amount": 5 }]

integrationMeta

string[]

required

Integration metadata.

Example:

[
  {
    "type": "API",
    "key": "integration-key",
    "value": {}
  }
]

ratings

object

Ratings of the experience.

Example:

{
  "rating": 4.8,
  "recommendability": 95,
  "total": 200
}

externalField

object

External field details.

Example:

{
  "type": "url",
  "value": "https://external-link.com"
}

minimumRequiredToBook

object

Minimum participants required for booking.

Example:

2

maximumAllowedToBook

object

Maximum participants allowed to book.

Example:

5

displayedCapacity

object

Displayed capacity.

Example:

20

cancellationPolicyId

object

Cancellation policy ID.

Example:

"policy-123"

⌘I

Get experience

curl --request GET \
  --url https://api.letsway.com/v1/brands/{brandId}/experiences/{experienceId} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.letsway.com/v1/brands/{brandId}/experiences/{experienceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.letsway.com/v1/brands/{brandId}/experiences/{experienceId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": {
    "id": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b",
    "title": "Sunset Sailing Tour",
    "slug": "sunset-sailing-tour-a54f004c",
    "headline": "A two-hour coastal cruise with drinks at golden hour.",
    "description": "<p>Set sail along the coast at golden hour - a two-hour cruise with drinks and canapés included.</p>.",
    "vibes": [
      {
        "id": "f047e2cb-1fb5-4374-8f3e-4bfcc6d7284e",
        "name": "Winter"
      },
      {
        "id": "da568b2b-24c4-4b4a-9ac5-7010986368d3",
        "name": "Summer"
      }
    ],
    "category": {
      "id": "c80c38ad-7379-42b0-ae92-bc26de382a0b",
      "name": "Family"
    },
    "location": {
      "id": "0e4e5db1-de94-41f8-9713-5074f9f0645a",
      "longitude": -97.7430608,
      "latitude": 30.267153,
      "name": "Austin, TX, USA",
      "timezoneId": "America/Chicago",
      "additionalInfo": ""
    },
    "maxParticipantsCount": 10,
    "sessionDurationMinutes": 60,
    "currency": "USD",
    "coverPicture": {
      "id": "0a4cd3a1-d099-4916-90ea-7e5012c06598",
      "mimeType": "image/jpeg",
      "uri": {
        "original": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "384w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "480w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "640w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "750w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
        "1080w": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg"
      }
    },
    "pictures": [],
    "medias": [
      {
        "id": "0a4cd3a1-d099-4916-90ea-7e5012c06598",
        "type": "image",
        "kind": "cover",
        "altText": null,
        "links": [
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "original"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "384"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "480"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "640"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "750"
          },
          {
            "url": "https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg",
            "type": "image",
            "resolution": "1080"
          }
        ]
      }
    ],
    "bookingAvailabilityMode": "group",
    "providedItems": [],
    "healthAndSafety": "",
    "isExclusive": false,
    "isBookable": true,
    "isUnlisted": false,
    "type": "recurring",
    "hostedBy": {
      "id": "c7c21aa6-110b-48d9-a970-47658473302a",
      "profilePicture": null,
      "firstName": "Sam",
      "lastName": " ",
      "emailAddress": "alice@example.com",
      "description": null,
      "allowOverlappingBookings": false
    },
    "externalField": null,
    "paymentMethods": [
      "credit-card",
      "room-charge",
      "member-number"
    ],
    "priceTiers": [
      {
        "id": "6c59db13-2c63-43b9-b91b-6267544f5fdb",
        "name": "Participant",
        "price": 100
      }
    ],
    "taxes": [],
    "integrationMeta": [],
    "partySize": null,
    "hidePrice": false,
    "isNoHost": true,
    "isTicketed": false,
    "shouldValidateComplimentaryBooking": {},
    "firstAvailableDate": {
      "scheduledDate": "2026-07-15",
      "sessions": [
        {
          "supportedParticipantsCount": 10,
          "startTime": "10:00:00",
          "duration": 60
        }
      ]
    },
    "descriptionPicture": null,
    "kind": "experience",
    "minimumRequiredToBook": null,
    "maximumAllowedToBook": null,
    "number": null,
    "displayedCapacity": null,
    "shape": null,
    "position": null,
    "resourceGroupId": null,
    "cancellationPolicyId": null,
    "reschedulePolicyId": null,
    "limitedTimeId": null,
    "customCallToAction": null
  }
}

Getting started

Listings

Availability

Carts & Checkout

Bookings

Experiences

Brand Configuration

Waitlists

Integrations

Organizations

Authorizations

Path Parameters

Query Parameters

Response