Skip to main content
GET
/
v1
/
brands
/
{brandId}
/
experiences
/
{experienceId}
Get experience
curl --request GET \
  --url https://api.letsway.com/v1/brands/{brandId}/experiences/{experienceId}
{
  "id": "exp-123",
  "title": "Scuba Diving in Bali",
  "slug": "scuba-diving-bali",
  "headline": "Dive into the crystal-clear waters of Bali",
  "description": "An exciting scuba diving adventure in Bali",
  "vibes": [
    {
      "id": "vibe-123",
      "name": "Relaxing"
    }
  ],
  "category": {
    "id": "cat-123",
    "name": "Adventure"
  },
  "location": {
    "longitude": -122.4194,
    "latitude": 37.7749,
    "name": "San Francisco",
    "timezoneId": "America/Los_Angeles",
    "additionalInfo": "Near the Golden Gate Bridge"
  },
  "maxParticipantsCount": 10,
  "sessionDurationMinutes": 120,
  "currency": "USD",
  "coverPicture": {
    "id": "uuid-value",
    "uri": {
      "original": "https://example.com/image.jpg"
    },
    "kind": "gallery"
  },
  "pictures": [
    {
      "id": "uuid-value",
      "uri": {
        "original": "https://example.com/image.jpg"
      },
      "kind": "gallery"
    }
  ],
  "medias": [
    {
      "id": "uuid-value",
      "uri": {
        "original": "https://example.com/image.jpg"
      },
      "kind": "gallery"
    }
  ],
  "bookingAvailabilityMode": "instant",
  "providedItems": [
    "Diving suit",
    "Oxygen tank"
  ],
  "healthAndSafety": "Life jacket required",
  "isExclusive": true,
  "isBookable": true,
  "isUnlisted": false,
  "type": "adventure",
  "hostedBy": {
    "id": "user-123",
    "profilePicture": {
      "id": "uuid-value",
      "uri": {
        "original": "https://example.com/image.jpg"
      },
      "kind": "gallery"
    },
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "description": "Experienced tour guide",
    "allowOverlappingBookings": true
  },
  "paymentMethods": [
    "credit-card",
    "cash"
  ],
  "priceTiers": [
    {
      "name": "Standard",
      "price": 50
    }
  ],
  "taxes": [
    {
      "name": "VAT",
      "amount": 5
    }
  ],
  "integrationMeta": [
    {
      "type": "API",
      "key": "integration-key",
      "value": {}
    }
  ],
  "ratings": {
    "rating": 4.8,
    "recommendability": 95,
    "total": 200
  },
  "externalField": {
    "type": "url",
    "value": "https://external-link.com"
  },
  "minimumRequiredToBook": 2,
  "maximumAllowedToBook": 5,
  "displayedCapacity": 20,
  "cancellationPolicyId": "policy-123"
}

Path Parameters

​
experienceId
string

Query Parameters

​
language
string

Response

200 - application/json

Get experience

​
id
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

​
category
object
required

Category of the experience

​
location
object
required

Location details

​
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

​
pictures
object[]
required

Additional pictures

​
medias
object[]
required

Media assets

​
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

​
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"