How to Get Resort Property Details, Amenities, and Accessibility
After identifying a resort property from search results, you can retrieve detailed information about it. The Resorts API provides two related endpoints: one for general property details and one for specific facility categories.
Property Details Endpoint
GET {{apihost}}/resorts/api/v2/property/{propertyid}
Required Headers
| Header | Value | Required |
|---|---|---|
x-api-key | Your API key | Yes |
x-correlation-id | Unique correlation identifier | Yes |
Accept-Language | Language code (e.g., en-US, es-ES) | No |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
property_id | string | Yes | The property ID returned from the search endpoint |
Example Request
GET {{api_host}}/resorts/api/v2/property/RST-98765
Example Response
JSON
{
"status": 200,
"data": {
"name": "Oceanfront Paradise Resort & Spa",
"checkin": "16:00",
"checkout": "11:00",
"address": {
"line_1": "100 Beachfront Drive",
"city": "Kailua-Kona",
"state": "HI",
"country": "US",
"postal_code": "96740"
},
"images": [
"https://images.example.com/resort-main.jpg",
"https://images.example.com/resort-pool.jpg",
"https://images.example.com/resort-room.jpg"
],
"location": {
"lat": 19.64,
"lon": -155.9969
},
"policies": {
"cancellation": "Free cancellation up to 72 hours before check-in.",
"pets": "No pets allowed.",
"smoking": "Non-smoking property."
},
"ratings": {
"star_rating": 4,
"user_rating": 8.7
},
"region": "aGF3YWlp",
"supplySource": "direct"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
name | string | Display name of the property |
checkin | string | Earliest check-in time (24-hour format) |
checkout | string | Latest check-out time (24-hour format) |
address | object | Full property address |
images | array | Array of image URLs for the property |
location | object | Latitude and longitude of the property |
policies | object | Property policies (cancellation, pets, smoking, etc.) |
ratings | object | Star rating and average user rating |
region | string | Region code the property belongs to |
supplySource | string | Inventory supply source identifier |
Localization
To receive property details in a specific language, include the Accept-Language header with a valid language code. For example:
Accept-Language: es-ES
Not all properties support all languages. If the requested language is not available, the API returns the default English content.
Facilities Endpoint
Use the same property endpoint with a facility query parameter to retrieve specific facility categories.
GET {{apihost}}/resorts/api/v2/property/{propertyid}?facility={facility_type}
Facility Types
| Value | Description |
|---|---|
accessibilities | Accessibility features and accommodations |
airports | Nearby airports with distance information |
amenities | On-site and off-site amenities |
Accessibilities
GET {{api_host}}/resorts/api/v2/property/RST-98765?facility=accessibilities
Example Response
JSON
{
"status": 200,
"data": {
"features": [
"Wheelchair-accessible parking",
"Roll-in shower",
"Accessible bathroom"
],
"elevator": true,
"equipmentForDeaf": true,
"braileOrRaisedSignage": false
}
}Accessibility Fields
| Field | Type | Description |
|---|---|---|
features | array | List of specific accessibility features available |
elevator | boolean | Whether the property has elevator access |
equipmentForDeaf | boolean | Whether equipment for deaf or hard-of-hearing guests is available |
braileOrRaisedSignage | boolean | Whether braille or raised signage is available |
Airports
GET {{api_host}}/resorts/api/v2/property/RST-98765?facility=airports
Example Response
JSON
{
"status": 200,
"data": [
{
"name": "Ellison Onizuka Kona International Airport",
"code": "KOA",
"distanceinmiles": 8.2,
"distanceinkms": 13.2
},
{
"name": "Hilo International Airport",
"code": "ITO",
"distanceinmiles": 78.5,
"distanceinkms": 126.3
}
]
}Airport Fields
| Field | Type | Description |
|---|---|---|
name | string | Full name of the airport |
code | string | IATA airport code |
distanceinmiles | number | Distance from the property in miles |
distanceinkms | number | Distance from the property in kilometers |
Amenities
GET {{api_host}}/resorts/api/v2/property/RST-98765?facility=amenities
Example Response
JSON
{
"status": 200,
"data": [
{
"name": "Swimming Pool",
"proximity": "Onsite",
"group_type": "Recreation",
"distances": null
},
{
"name": "Full-Service Spa",
"proximity": "Onsite",
"group_type": "Wellness",
"distances": null
},
{
"name": "Golf Course",
"proximity": "Offsite",
"group_type": "Recreation",
"distances": {
"miles": 2.5,
"kms": 4
}
}
]
}Amenity Fields
| Field | Type | Description |
|---|---|---|
name | string | Name of the amenity |
proximity | string | "Onsite" or "Offsite" |
group_type | string | Category grouping (e.g., Recreation, Wellness, Dining) |
distances | object or null | Distance information for off-site amenities. null for on-site amenities. |
Best Practices
- Cache property details — Property details (name, address, images, policies) change infrequently. Cache these responses to reduce API calls and improve performance.
- Fetch facilities on demand — Only request specific facility types when the user needs them, rather than fetching all three categories upfront.
- Display accessibility clearly — Surface accessibility information prominently for guests who need it. Use the boolean fields for quick filtering and the
featuresarray for detailed display. - Show nearest airport — Use the airports facility data to help guests plan their travel. Sort by distance to highlight the most convenient option.