Get bookings - Way Docs

GET

bookings

Get bookings

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

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

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

{
  "items": [
    {
      "id": "019f5ca1-4dc1-775d-a40d-833f44bfccf4",
      "confirmationCode": "U7dSqlzCA",
      "cartId": "1ccd47b4-8784-43a0-86a5-fc733265f3c4",
      "cartConfirmationCode": "55xNJqU3Q",
      "amount": 100,
      "currency": "USD",
      "amountRefunded": 0,
      "amountVoided": 0,
      "event": {
        "timezone": "America/Chicago",
        "startDateTime": "2026-07-14T10:00:00"
      },
      "experience": {
        "id": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b",
        "title": "Sunset Sailing Tour"
      },
      "listing": {
        "id": "d9fa9229-9132-415d-bc04-513062ee3bcd"
      },
      "resourceGroupCollection": null,
      "resourceGroup": null,
      "status": "confirmed",
      "purchaser": {
        "id": "019f5ca1-5432-751e-8663-7b999f0f7ede",
        "firstName": "Alice",
        "lastName": "Rivera",
        "emailAddress": "alice@example.com",
        "phoneNumber": "+15550100"
      },
      "participants": [
        {
          "id": "019f5ca1-5432-751e-8663-7c22693a6e7e",
          "firstName": "Alice",
          "lastName": "Rivera",
          "emailAddress": null,
          "phoneNumber": null,
          "priceTierName": "Participant",
          "cancelledAt": null
        }
      ],
      "paymentMethod": "cash",
      "paymentDetail": {},
      "createdAt": "2026-07-13T17:58:23.757Z",
      "notes": null,
      "internalNotes": null,
      "addOns": []
    }
  ],
  "meta": {
    "totalItems": 1,
    "itemCount": 1,
    "itemsPerPage": 15,
    "totalPages": 1,
    "currentPage": 1
  },
  "links": {
    "first": "/v1/bookings?cartConfirmationCode=55xNJqU3Q&limit=15",
    "previous": "",
    "next": "",
    "last": "/v1/bookings?cartConfirmationCode=55xNJqU3Q&page=1&limit=15"
  }
}

Authorizations

Authorization

string

header

required

Your brand's secret API key, e.g. Bearer way_sk_live_bhEqcn0i1fRoUEHBPjJkQA. Older Way-Brand-Id + Way-Secret-Key credentials still work: see Legacy authentication.

Query Parameters

bookingIds

string[]

Only these bookings, by ID.

Minimum array length: 1

cartConfirmationCode

string

Only bookings from the cart with this confirmation code - the code returned by the book-bulk call.

cartId

string<uuid>

Only bookings created from this cart.

confirmationCode

string

The booking's own confirmation code - the code the guest sees.

createdFrom

string

Only bookings created at or after this date-time.

Pattern: ^\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$

createdTo

string

Only bookings created at or before this date-time.

Pattern: ^\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$

excludeCancelled

enum<string>

Set to true to omit cancelled bookings.

Available options:

true,

false

excludeFailed

enum<string>

Set to true to omit failed bookings.

Available options:

true,

false

experienceId

string<uuid>

Only results for this experience.

filters

any[]

Structured filters, e.g. filters[0][name]=experienceDateRange&filters[0][operator]=range&filters[0][value][from]=2026-08-15&filters[0][value][to]=2026-08-16.

limit

number

default:10

Number of items per page.

Required range: x >= 0

loyaltyProgramId

string

Only bookings linked to this loyalty program.

memberId

string

Only bookings made by this loyalty-program member.

methodNumber

string

Only bookings paid with this room or member number.

organizationId

string<uuid>

Only bookings belonging to this organization.

page

number

default:1

Page number to return, starting at 1.

Required range: x >= 1

promoted

enum<string>

Set to true to return only bookings of listings promoted from other brands.

Available options:

true,

false

purchaserEmail

string

Only bookings purchased with this email address.

purchaserLastName

string

Only bookings whose purchaser has this last name.

string

Free-text search over the listings' titles and descriptions.

resourceGroupCollectionId

string<uuid>

Scope results to a resource-group collection.

sortBy

enum<string>

Field to sort the results by.

Available options:

purchaser,

experience,

dateBooked,

amount,

status,

brand,

sessionDate

sortDir

enum<string>

Sort direction.

Available options:

ASC,

DESC

updatedFrom

string

Only bookings updated at or after this date-time - the workhorse filter for reconciliation jobs.

Pattern: ^\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$

updatedTo

string

Only bookings updated at or before this date-time.

Pattern: ^\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$

Response

200 - application/json

Booking details.

items

object[]

required

List of experiences.

Show child attributes

links

object

required

Pagination links.

Show child attributes

⌘I

Get bookings

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

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

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

{
  "items": [
    {
      "id": "019f5ca1-4dc1-775d-a40d-833f44bfccf4",
      "confirmationCode": "U7dSqlzCA",
      "cartId": "1ccd47b4-8784-43a0-86a5-fc733265f3c4",
      "cartConfirmationCode": "55xNJqU3Q",
      "amount": 100,
      "currency": "USD",
      "amountRefunded": 0,
      "amountVoided": 0,
      "event": {
        "timezone": "America/Chicago",
        "startDateTime": "2026-07-14T10:00:00"
      },
      "experience": {
        "id": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b",
        "title": "Sunset Sailing Tour"
      },
      "listing": {
        "id": "d9fa9229-9132-415d-bc04-513062ee3bcd"
      },
      "resourceGroupCollection": null,
      "resourceGroup": null,
      "status": "confirmed",
      "purchaser": {
        "id": "019f5ca1-5432-751e-8663-7b999f0f7ede",
        "firstName": "Alice",
        "lastName": "Rivera",
        "emailAddress": "alice@example.com",
        "phoneNumber": "+15550100"
      },
      "participants": [
        {
          "id": "019f5ca1-5432-751e-8663-7c22693a6e7e",
          "firstName": "Alice",
          "lastName": "Rivera",
          "emailAddress": null,
          "phoneNumber": null,
          "priceTierName": "Participant",
          "cancelledAt": null
        }
      ],
      "paymentMethod": "cash",
      "paymentDetail": {},
      "createdAt": "2026-07-13T17:58:23.757Z",
      "notes": null,
      "internalNotes": null,
      "addOns": []
    }
  ],
  "meta": {
    "totalItems": 1,
    "itemCount": 1,
    "itemsPerPage": 15,
    "totalPages": 1,
    "currentPage": 1
  },
  "links": {
    "first": "/v1/bookings?cartConfirmationCode=55xNJqU3Q&limit=15",
    "previous": "",
    "next": "",
    "last": "/v1/bookings?cartConfirmationCode=55xNJqU3Q&page=1&limit=15"
  }
}