Listings
Get all listings
Returns the brand’s published listings with pagination, sorting, and filtering by category, vibe, and product line.
Scoped to a single brand. An organization key must add a Way-Brand-Id header naming one of its brands, otherwise the request fails with 404 Not Found.
GET
/
v3
/
listings
Get all listings
curl --request GET \
--url https://api.letsway.com/v3/listings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.letsway.com/v3/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsway.com/v3/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"advertisedPrice": 100,
"bookingAvailabilityMode": "group",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"category": {
"id": "c80c38ad-7379-42b0-ae92-bc26de382a0b",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Family"
},
"eventDates": null,
"experienceId": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b",
"hidePrice": false,
"hostedBy": null,
"id": "d9fa9229-9132-415d-bc04-513062ee3bcd",
"isExclusive": false,
"kind": "experience",
"maxParticipants": 10,
"medias": [
{
"id": "0a4cd3a1-d099-4916-90ea-7e5012c06598",
"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
}
],
"pointsEligible": null,
"pricePerType": "Participant",
"productLine": "reserve",
"promotedListing": null,
"rating": null,
"resourceGroupCollectionId": null,
"resourceGroups": [],
"slug": "sunset-sailing-tour-a54f004c",
"startingPrice": 100,
"summary": "A two-hour coastal cruise with drinks at golden hour.",
"title": "Sunset Sailing Tour",
"vibes": [
{
"id": "f047e2cb-1fb5-4374-8f3e-4bfcc6d7284e",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Winter"
},
{
"id": "da568b2b-24c4-4b4a-9ac5-7010986368d3",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Summer"
}
]
},
{
"advertisedPrice": 10,
"bookingAvailabilityMode": "group",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"category": {
"id": "a3a98c9c-99fb-46ae-8586-d27ee8899c02",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Recreation"
},
"eventDates": null,
"experienceId": "9d82da98-d831-4797-bdff-e3177e0a810e",
"hidePrice": false,
"hostedBy": {
"id": "1c0340e2-ff93-41b1-b0ad-2c91720319a6",
"firstName": "Maya",
"lastName": "Kim",
"description": "",
"profilePicture": null
},
"id": "be9ae416-6883-4356-9dec-33fab4f7a274",
"isExclusive": false,
"kind": "experience",
"maxParticipants": 15,
"medias": [
{
"id": "0a3cd734-e662-4568-8a5e-2fd74b3be116",
"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
}
],
"pointsEligible": null,
"pricePerType": "tier1",
"productLine": "host",
"promotedListing": null,
"rating": null,
"resourceGroupCollectionId": null,
"resourceGroups": [],
"slug": "wine-tasting-evening-adf159b0",
"startingPrice": 10,
"summary": "A relaxed evening of regional wines with our sommelier.",
"title": "Wine Tasting Evening",
"vibes": [
{
"id": "f047e2cb-1fb5-4374-8f3e-4bfcc6d7284e",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Winter"
}
]
}
],
"meta": {
"totalItems": 108,
"itemCount": 10,
"itemsPerPage": 10,
"totalPages": 11,
"currentPage": 1
}
}Authorizations
Brand-API-KeyOrganization-API-Key
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
The brand to scope the response to. Required with an organization key. Ignored with a brand key, which already names its brand.
Query Parameters
Only listings in these categories. IDs come from the Get categories endpoint.
Set to true to return unlisted listings instead of publicly listed ones.
Locale for translated content; defaults to the brand's language.
Number of items per page.
Required range:
x >= 0Page number to return, starting at 1.
Required range:
x >= 1Only listings from these product lines.
Available options:
activate, host, reserve Field to sort the results by.
Available options:
category, createdAt, status, title, listingOrder Sort direction.
Available options:
ASC, DESC Only listings with these vibes. IDs come from the Get vibes endpoint.
Was this page helpful?
⌘I
Get all listings
curl --request GET \
--url https://api.letsway.com/v3/listings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.letsway.com/v3/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsway.com/v3/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"advertisedPrice": 100,
"bookingAvailabilityMode": "group",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"category": {
"id": "c80c38ad-7379-42b0-ae92-bc26de382a0b",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Family"
},
"eventDates": null,
"experienceId": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b",
"hidePrice": false,
"hostedBy": null,
"id": "d9fa9229-9132-415d-bc04-513062ee3bcd",
"isExclusive": false,
"kind": "experience",
"maxParticipants": 10,
"medias": [
{
"id": "0a4cd3a1-d099-4916-90ea-7e5012c06598",
"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
}
],
"pointsEligible": null,
"pricePerType": "Participant",
"productLine": "reserve",
"promotedListing": null,
"rating": null,
"resourceGroupCollectionId": null,
"resourceGroups": [],
"slug": "sunset-sailing-tour-a54f004c",
"startingPrice": 100,
"summary": "A two-hour coastal cruise with drinks at golden hour.",
"title": "Sunset Sailing Tour",
"vibes": [
{
"id": "f047e2cb-1fb5-4374-8f3e-4bfcc6d7284e",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Winter"
},
{
"id": "da568b2b-24c4-4b4a-9ac5-7010986368d3",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Summer"
}
]
},
{
"advertisedPrice": 10,
"bookingAvailabilityMode": "group",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"category": {
"id": "a3a98c9c-99fb-46ae-8586-d27ee8899c02",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Recreation"
},
"eventDates": null,
"experienceId": "9d82da98-d831-4797-bdff-e3177e0a810e",
"hidePrice": false,
"hostedBy": {
"id": "1c0340e2-ff93-41b1-b0ad-2c91720319a6",
"firstName": "Maya",
"lastName": "Kim",
"description": "",
"profilePicture": null
},
"id": "be9ae416-6883-4356-9dec-33fab4f7a274",
"isExclusive": false,
"kind": "experience",
"maxParticipants": 15,
"medias": [
{
"id": "0a3cd734-e662-4568-8a5e-2fd74b3be116",
"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
}
],
"pointsEligible": null,
"pricePerType": "tier1",
"productLine": "host",
"promotedListing": null,
"rating": null,
"resourceGroupCollectionId": null,
"resourceGroups": [],
"slug": "wine-tasting-evening-adf159b0",
"startingPrice": 10,
"summary": "A relaxed evening of regional wines with our sommelier.",
"title": "Wine Tasting Evening",
"vibes": [
{
"id": "f047e2cb-1fb5-4374-8f3e-4bfcc6d7284e",
"brandId": "f2ce0a06-7997-4626-9532-65ac70f3a19c",
"name": "Winter"
}
]
}
],
"meta": {
"totalItems": 108,
"itemCount": 10,
"itemsPerPage": 10,
"totalPages": 11,
"currentPage": 1
}
}