Skip to main content
GET
/
v2
/
listings
Get listings v2
curl --request GET \
  --url https://api.letsway.com/v2/listings
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "description": "<string>",
      "summary": "<string>",
      "experienceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "resourceGroupCollectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "experience",
      "productLine": "activate",
      "startingPrice": 123,
      "pricePerType": "<string>",
      "minParticipants": 123,
      "maxParticipants": 123,
      "coverMedia": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "kind": "gallery",
        "type": "image",
        "links": [
          {
            "type": "image",
            "url": "<string>",
            "resolution": "original"
          }
        ]
      },
      "brandId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "brandCurrency": "<string>",
      "location": {
        "name": "<string>",
        "latitude": 123,
        "longitude": 123,
        "timezoneId": "<string>",
        "additionalInfo": "<string>"
      },
      "slug": "<string>",
      "customFields": [
        {
          "name": "<string>",
          "values": [
            "<string>"
          ],
          "externalId": "<string>"
        }
      ],
      "rating": 123,
      "categoryName": "<string>",
      "dates": [
        "2023-11-07T05:31:56Z"
      ],
      "hidePrice": true,
      "isUnlisted": true,
      "category": {
        "id": "<string>",
        "name": "<string>"
      },
      "vibes": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "bookingAvailabilityMode": "private",
      "isExclusive": true,
      "medias": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "kind": "gallery",
          "type": "image",
          "links": [
            {
              "type": "image",
              "url": "<string>",
              "resolution": "original"
            }
          ]
        }
      ],
      "hostedById": "<string>",
      "featuredOrder": 123,
      "order": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "publishedAt": "2023-11-07T05:31:56Z",
      "firstAvailableDate": "2023-11-07T05:31:56Z",
      "customCallToAction": "<string>",
      "externalBrandReferenceId": "<string>",
      "auction": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "brandId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "resourceGroupCollectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "status": "preview",
        "biddingOpenDateTime": "2023-11-07T05:31:56Z",
        "biddingCloseDateTime": "2023-11-07T05:31:56Z",
        "claimTimeMinutes": 123,
        "publishedStatus": "preview",
        "winningAmount": "<string>",
        "winningBidderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "bidsCount": 123,
        "uniqueBiddersCount": 123,
        "startingAmount": "<string>",
        "minBidIncrement": "<string>"
      }
    }
  ],
  "meta": {
    "itemCount": 123,
    "itemsPerPage": 123,
    "currentPage": 123,
    "totalItems": 123,
    "totalPages": 123
  },
  "links": {
    "first": "<string>",
    "previous": "<string>",
    "next": "<string>",
    "last": "<string>"
  }
}

Query Parameters

page
number
default:1
Required range: x >= 1
limit
number
default:10
Required range: x >= 0
sortDir
enum<string>
Available options:
ASC,
DESC
sortBy
enum<string>
Available options:
startingPrice,
rating,
order,
featuredOrder,
firstAvailableDate,
createdAt,
publishedAt,
timeLeft
q
string
isUnlisted
enum<string>
default:false
Available options:
true,
false
kinds
enum<string>[]
Available options:
experience,
resource,
event,
auction
productLines
enum<string>[]
Available options:
activate,
host,
reserve
categories
string[]
participantCount
number
customFields
object[]
from
string
to
string
excludePromotedListings
enum<string>
Available options:
true
categoryIds
string<uuid>[]
vibeIds
string<uuid>[]
language
enum<string>
Available options:
de-DE,
en-GB,
en-US,
es-ES,
fr-FR,
it-IT,
ja-JP,
ko-KR,
pt-BR,
ru-RU,
zh-Hans,
zh-Hant
Available options:
true

Response

200 - application/json
items
object[]
required
meta
object
required