Skip to main content

Endpoint

POST /api/v1/content/accommodations

Authentication

  • Required header: api-key: <partner-api-key>

Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
api-keyYesPartner API key

Request Body

FieldTypeRequiredNotes
countriesstring[]NoCountry filter list; currently only US is supported
sizenumberNoPage size, range 1-100, default 100
pageTokenstringNoCursor token for next page

Pagination Behavior

  1. First request: send filters (type/countries/size) without pageToken.
  2. If response has hasMore = true, call again with pageToken = nextPageToken.
  3. When passing both pageToken and filters, type/countries/size must match token values.

Example Request (First Page)

{
  "type": "accommodation",
  "countries": ["US"],
  "size": 100
}

Example Request (Next Page)

{
  "pageToken": "<nextPageToken>"
}

Success Response

{
  "data": {
    "type": "inventory",
    "countries": ["US"],
    "size": 100,
    "hasMore": true,
    "nextPageToken": "<nextPageToken>",
    "accommodations": [
      {
        "code": "694509f7a4dec2995fe3072b",
        "location": [
          -115.076026,
          36.12388
        ],
        "images": [
          {
            "priority": 0,
            "thumbnail": "https://q-xx.bstatic.com/xdata/images/hotel/100x100/32478237.jpg?k=fd25eb467399a5ef08219d380db24dc16cc06a2f589f79fd031ad676002fa7f5&o=",
            "url": "https://q-xx.bstatic.com/xdata/images/hotel/max500/32478237.jpg?k=fd25eb467399a5ef08219d380db24dc16cc06a2f589f79fd031ad676002fa7f5&o="
          }
        ],
        "contact": {
          "phone": "17029519000",
          "fax": "1-702-951-1046",
          "email": "fit.reservations@goldenent.com"
        },
        "address": {
          "address": "4575 Boulder Highway",
          "city": "Las Vegas (NV)",
          "state": "Nevada",
          "country": "US",
          "postalCode": "89121"
        },
        "localizedName": [
          {
            "language": "en",
            "region": "us",
            "locale": "en_us",
            "content": "Arizona Charlie's Boulder"
          }
        ],
        "localizedDescription": [
          {
            "language": "en",
            "region": "us",
            "locale": "en_us",
            "content": [
              {
                "type": "ADDITIONAL",
                "content": "Mandatory fees: <p>You'll be asked to pay the following charges at the property. Fees may include applicable taxes:</p> <ul><li>Deposit: USD 150 per accommodation, per stay</li><li>Resort fee: USD 33.89 per accommodation, per night</li></ul> The resort fee includes:<ul><li>In-room coffee</li><li>Phone calls</li><li>Pool access</li></ul>"
              },
              {
                "type": "GENERAL",
                "content": "Try your luck at the casino and enjoy other recreational amenities including an outdoor pool and a hot tub. Additional features at this hotel include complimentary wireless internet access, gift shops/newsstands, and a banquet hall.. Featured amenities include complimentary wired internet access, express check-out, and a 24-hour front desk. Free self parking is available onsite.. "
              },
              {
                "type": "LOCATION",
                "content": "Located in Las Vegas, Arizona Charlie's Boulder is a 3-minute drive from Fremont Street and 6 minutes from The Club at Sunrise.  This casino hotel is 5 mi (8.1 km) from Las Vegas Convention Center and 5.4 mi (8.6 km) from Cowabunga Bay Water Park.. Distances are displayed to the nearest 0.1 mile and kilometer. <br /> <p>Boulder Strip - 0.1 km / 0.1 mi <br /> Boulder Station Hotel and Casino - 1.6 km / 1 mi <br /> Sam's Town - 2 km / 1.3 mi <br /> Fremont Street - 3.8 km / 2.4 mi <br /> The Club at Sunrise - 4.5 km / 2.8 mi <br /> University of Nevada, Las Vegas - 7.2 km / 4.5 mi <br /> Las Vegas Convention Center - 8.1 km / 5 mi <br /> Atomic Museum - 8.2 km / 5.1 mi <br /> Hughes Center - 8.3 km / 5.2 mi <br /> Zak Bagans Haunted Museum - 8.5 km / 5.3 mi <br /> Vegas Indoor Skydiving - 8.5 km / 5.3 mi <br /> Cowabunga Bay Water Park - 8.6 km / 5.4 mi <br /> Sahara Las Vegas Casino - 8.8 km / 5.5 mi <br /> Stratosphere Tower - 9 km / 5.6 mi <br /> Casino at the Stratosphere - 9 km / 5.6 mi <br /> </p><p>The nearest airports are:<br />Harry Reid Intl. Airport (LAS) - 11.4 km / 7.1 mi<br /> Henderson, NV (HSH-Henderson Executive) - 30.1 km / 18.7 mi<br /> Boulder City, NV (BLD-Boulder City Municipal) - 32.6 km / 20.2 mi<br /> </p><p>The preferred airport for Arizona Charlie's Boulder is Harry Reid Intl. Airport (LAS). </p>. Near Sam's Town. "
              },
              {
                "type": "RESTAURANT",
                "content": "Enjoy a meal at Sourdough Cafe or snacks in the hotel's 2 coffee shops/cafes. Need to unwind? Take a break with a tasty beverage at one of the 3 bars/lounges. Cooked-to-order breakfasts are available daily from 8:00 AM to 10:30 AM for a fee.. "
              },
              {
                "type": "ROOM",
                "content": "Stay in one of 301 guestrooms featuring Smart televisions. Complimentary wired and wireless internet access keeps you connected, and digital programming provides entertainment. Private bathrooms with shower/tub combinations feature complimentary toiletries and hair dryers. Conveniences include coffee/tea makers and blackout drapes/curtains, and housekeeping is provided daily.. "
              }
            ]
          }
        ],
        "type": "hotel",
        "amenities": [
          "parking::paid",
          "wifi",
          "pool"
        ],
        "timezone": "America/Los_Angeles",
        "checkInPolicy": {
          "checkInFrom": "15:00",
          "checkInUntil": "03:00",
          "checkOutUntil": "11:00",
          "checkinInstructions": [
            {
              "language": "en",
              "region": "us",
              "locale": "en_us",
              "content": "Check-in start time: 3:00 PM; Check-in end time: 3:00 AM\nMinimum check-in age: 21 "
            }
          ],
          "checkinSpecialInstructions": [
            {
              "language": "de",
              "content": "Die Mitarbeiter der Rezeption heißen dich bei deiner Ankunft willkommen."
            },
            {
              "language": "en",
              "content": "Front desk staff will greet guests on arrival at the property. Information provided by the property may be translated using automated translation tools."
            }
          ],
          "checkoutSpecialInstructions": [],
          "minAge": 21,
          "checkOutFrom": "11:00"
        },
        "starRating": 4
      }
    ]
  },
  "message": "success"
}

Response Field Notes

  • data.accommodations[].code is the accommodation code used by searchCriteria.destinations.accommodations[].code

Common Errors

  • 400 Unsupported country: XX. Currently only US is supported
  • 400 Unsupported type
  • 400 Invalid pageToken format
  • 400 type in query must match type in pageToken
  • 400 countries in query must match countries in pageToken
  • 400 size in query must match size in pageToken
  • 401 pageToken does not belong to the current partner
  • 401 Invalid pageToken signature
  • 401 pageToken expired