OpenTravel 2020A Facility Resource
Swagger 2.0 resource contract generated from the OpenTravel 2.0 Object Model, 2020A Object Suite. Defines POST /Facilities and GET /Facilities/{Identifier} with 232 model definitions covering hospitality and golf facility description. Published as a specification artifact with host example.com and basePath /resource/v1_0; OpenTravel operates no runtime endpoint for it.
OpenTravel 2020A Facility Resource is one of 4 APIs that OpenTravel Alliance publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 3 JSON Schema definitions.
Tagged areas include Hospitality, Facilities, and OpenTravel 2.0. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 3 JSON Schemas.
This API exposes 2 operations across 2 paths, and defines 232 schemas. It is described by OpenAPI 2.0, at version 1.0.0.
2 operations
2 paths
232 schemas
1 GET1 POST
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 2
Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.
Operations 2
POST
/Facilities
FacilityResource - Post
GET
/Facilities/{Identifier}
FacilityResource - Get
Schemas 232
The contract defines 232 schemas that model the data the API accepts and returns. The most detailed are Recreation (17 properties), DetailedHotelSearchCriteria (15 properties), Directions (14 properties), RelativePosition (14 properties). Each schema is shown below with its type and property counts.
CourseID
object
4 properties
1 required
Course
CourseDetail
CourseClosure
object
3 properties
1 required
CourseClosureDetail
CourseConditions
object
4 properties
1 required
CourseRestrictions
object
5 properties
1 required
CourseRestrictionsDetail
DrivingRange
object
7 properties
1 required
GolfFacilityFeatures
object
4 properties
1 required
PracticeFacilities
object
6 properties
1 required
ProShopID
object
4 properties
1 required
ProShop
ClubHouse
object
3 properties
1 required
CourseType_Enum
string
The course type at the facility.
DrivingRangeType_Enum
string
Describes the type of driving range.
GolfFacility
object
12 properties
2 required
GolfFacilityDetail
RentalEquipment
object
5 properties
1 required
GolfRentalEquipment_Enum
object
Rental equipment.
2 properties
GolfRentalEquipment_Enum_Base
string
Rental equipment.
PersonCategory_Enum
object
2 properties
PersonCategory_Enum_Base
string
FacilityHighlights_Enum
object
Items offered at a facility.
2 properties
FacilityHighlights_Enum_Base
string
Items offered at a facility.
GolfServices_Enum
object
Services offered at a golf facility.
2 properties
GolfServices_Enum_Base
string
Services offered at a golf facility.
TeePosition
object
The tee position for the hole.
2 properties
ScoreCard
object
6 properties
1 required
CourseArchitect
object
Information regarding the architect of the course.
4 properties
ClubHouseFeatures_Enum
object
Features related to the club house.
2 properties
ClubHouseFeatures_Enum_Base
string
Features related to the club house.
PracticeFacilityFeatures_Enum
object
Features of the practice facility.
2 properties
PracticeFacilityFeatures_Enum_Base
string
Features of the practice facility.
FacilityGolf
NoticeID
object
4 properties
1 required
Notice
NoticeEnum
object
2 properties
NoticeEnum_Base
string
FacilityHotel
FacilityQueryHotel
object
10 properties
1 required
FacilityQueryHotelAvail
object
4 properties
1 required
FacilityQueryHotelAvailRetrieve
object
4 properties
2 required
FacilityKeyHotel
HotelDetails
object
13 properties
1 required
HotelCheckInOutPolicy
object
2 properties
DetailedHotelSearchCriteria
object
15 properties
1 required
BaseHospitalityFacilityQuery
object
9 properties
2 required
Recreation
object
17 properties
1 required
RecreationFeature
object
5 properties
1 required
GDS_Codes
object
3 properties
1 required
GDS_CodesDetail
GDS_Code
object
5 properties
1 required
GDS_CodeDetail
GDS_CodeInfo
object
4 properties
1 required
DocumentType_Enum
object
Defines the specific type of identification or certification document.
2 properties
DocumentType_Enum_Base
string
Defines the specific type of identification or certification document.
DurationUnit_Enum
object
Defines the 'Units' that can be applied to Stay restrictions.
2 properties
DurationUnit_Enum_Base
string
Defines the 'Units' that can be applied to Stay restrictions.
BedType_Enum
object
The type(s) of sleeping option(s) in a guest accommodation.
2 properties
BedType_Enum_Base
string
The type(s) of sleeping option(s) in a guest accommodation.
DisabilityFeature_Enum
object
Specifies information about a facility, amenity or service that is relevant to people with a disability.
2 properties
DisabilityFeature_Enum_Base
string
Specifies information about a facility, amenity or service that is relevant to people with a disability.
RecreationService_Enum
object
Describes the recreational activities available to a guest which may or may not be operated by or located at the hotel.
2 properties
RecreationService_Enum_Base
string
Describes the recreational activities available to a guest which may or may not be operated by or located at the hotel.
SecurityFeature_Enum
object
Identifies security features of the services, meeting rooms, guest rooms, and restaurants of a property.
2 properties
SecurityFeature_Enum_Base
string
Identifies security features of the services, meeting rooms, guest rooms, and restaurants of a property.
Status_Enum
object
The status condition.
2 properties
Status_Enum_Base
string
The status condition.
ErrorWarningType_Enum
object
Tthe category of error or warning.
2 properties
ErrorWarningType_Enum_Base
string
Tthe category of error or warning.
PhoneLocation_Enum
object
Where the phone is located.
2 properties
PhoneLocation_Enum_Base
string
Where the phone is located.
PhoneUseType_Enum
object
2 properties
PhoneUseType_Enum_Base
string
PhoneTechType_Enum
object
Defines the technology associated with this phone number.
2 properties
PhoneTechType_Enum_Base
string
Defines the technology associated with this phone number.
TimeUnit_Enum
string
CommunicationLocation_Enum
object
Specifies a location for communication.
2 properties
CommunicationLocation_Enum_Base
string
Specifies a location for communication.
AddressUse_Enum
object
Describes how an address is to be used.
2 properties
AddressUse_Enum_Base
string
Describes how an address is to be used.
UnitOfMeasure_Enum
string
The unit of measure in a code format. Refer to OpenTravel Code List Unit of Measure Code (UOM).
EmailAddressType_Enum
object
Specifies a type of email address.
2 properties
EmailAddressType_Enum_Base
string
Specifies a type of email address.
PositionAccuracy_Enum
string
Specifies the level of accuracy for the positon.
DayOfWeek_Enum
string
Day of the Week types.
Transportation_Enum
object
Type of tranportation: Air, Rail, Bus, Boat, Private Auto, Other.
2 properties
Transportation_Enum_Base
string
Type of tranportation: Air, Rail, Bus, Boat, Private Auto, Other.
ToFrom_Enum
string
Used to indicate whether the context is to a facility or from a facility.
ChargeUnit_Enum
object
Source: Charge Type (CHG) OpenTravel codelist.
2 properties
ChargeUnit_Enum_Base
string
Source: Charge Type (CHG) OpenTravel codelist.
SegmentCategory_Enum
object
Describes the segment type.
2 properties
SegmentCategory_Enum_Base
string
Describes the segment type.
ReferencePoint_Enum
object
Specifies a point of reference.
2 properties
ReferencePoint_Enum_Base
string
Specifies a point of reference.
AdditionalDetailType_Enum
object
Identifies the type of detail being sent.
2 properties
AdditionalDetailType_Enum_Base
string
Identifies the type of detail being sent.
InformationType_Enum
object
Identifies the type of information being sent.
2 properties
InformationType_Enum_Base
string
Identifies the type of information being sent.
PictureCategory_Enum
object
Specifies the category of the mulitmedia item.
2 properties
PictureCategory_Enum_Base
string
Specifies the category of the mulitmedia item.
RatePlanType_Enum
object
Note: Typically used for rate plans that may be published, e.g. have no qualifying criteria, or may be restricted or negotiated, e.g. has qualifying criteria f…
2 properties
RatePlanType_Enum_Base
string
Note: Typically used for rate plans that may be published, e.g. have no qualifying criteria, or may be restricted or negotiated, e.g. has qualifying criteria f…
Proximity_Enum
object
Specifies if the item in question is onsite, offsite, nearby, etc.
2 properties
Proximity_Enum_Base
string
Specifies if the item in question is onsite, offsite, nearby, etc.
RatingSymbol
string
Used to identify a symbol used in a rating (i.e. Diamonds, Stars).
RecreationFeatures_Enum
object
Provides further information on a recreation.
2 properties
RecreationFeatures_Enum_Base
string
Provides further information on a recreation.
ContactLocation_Enum
object
Specifies where the contact is located.
2 properties
ContactLocation_Enum_Base
string
Specifies where the contact is located.
RatePlanCode
object
A string value may be used to request a particular code or an ID if the guest qualifies for a specific rate, such as AARP, AAA, a corporate rate, etc., or to s…
8 properties
BasicPropertyInfo
object
7 properties
1 required
Site
object
3 properties
1 required
BasicPropertyInfoDetail
SiteDetail
FacilityID
object
4 properties
1 required
Facility_ORG0400
FacilityMeeting
PropertyID
object
4 properties
1 required
ResortID
object
4 properties
1 required
Property
Resort
PropertyDetail
ResortDetail
FacilityKey
object
2 properties
1 required
FacilityKeyIdentifier
FeatureSecurity
FeatureAccessibility
BusinessService
object
4 properties
1 required
MeetingCenter
object
8 properties
1 required
FacilityUnitCount
object
Specifies the counts for the units at a facility such as the number of restaurants, the number of meeting rooms and the number of guest rooms.
5 properties
Facility_ORG0401
FacilityList
object
1 property
PropertyInfo
object
3 properties
1 required
PropertyInfoDetail
GuestCount
object
Identifies the number of guests for the reservation.
3 properties
NameType
string
OTA Code list: Name Type\tNAM\t\n\t1\tFormer\n\t2\tNickname\n\t3\tAlternate\n\t4\tMaiden
OptInStatus_Enum
string
TextFormatType
string
YesNoInherit_Enum
string
AddressBldgRoom
object
2 properties
AddressStreetNumber
object
5 properties
CompanyName
object
Identifies a company by name.
9 properties
Country
object
ISO 3166 code for a country.
2 properties
CurrencyAmount
object
A monetary amount.
3 properties
DateTimeStamp
object
Time stamp of the creation.
6 properties
DateEffectiveExpire
object
Used to identify the effective date and\/or expiration date.
3 properties
Identifier
object
Identifier provides the ability to create a globally unique identifier. This could be GUID a UUID or any other string that an organization that distinctly iden…
4 properties
PersonName
object
6 properties
2 required
RelatedTraveler_Simple_Person_Name
object
6 properties
2 required
PersonNameDetail
RelatedTraveler_Simple_Person_NameDetail
Privacy
object
Allows for control of the sharing of data between parties.
5 properties
StateProv
object
The standard code or abbreviation for the state, province, or region.
2 properties
Telephone
object
8 properties
2 required
TelephoneDetail
Enum_TelephoneRole
object
2 properties
Enum_TelephoneRole_Base
string
Enum_TelephoneRole_Open
string
TextFree
object
Textual information to provide descriptions and\/or additional information.
2 properties
Text
object
Provides text and indicates whether it is formatted or not.
3 properties
TextParagraph
object
9 properties
1 required
Comment
object
9 properties
1 required
Description
object
9 properties
1 required
Restriction
object
9 properties
1 required
TimeSpan
object
Specifies the arrival date and departure date which covers the whole Reservation.
2 properties
2 required
URL
object
Web site address, in IETF specified format.
3 properties
ParagraphListItem
object
4 properties
DateTimeSpanWindows
object
3 properties
1 required
StayRestrictions
object
3 properties
1 required
DateTimeSpanWindowsDetail
StayRestrictionsDetail
Code
object
Any code used to specify an item, for example, type of traveler, service code, room amenity, etc. May be used to reference the OpenTravel RMA Codelist.
5 properties
PersonDocument
object
3 properties
1 required
PayloadStdAttributes
object
The standard attributes that appear on the root element for all OpenTravel messages.
12 properties
1 required
TargetEnvironment_Enum
string
TransactionStatusCode_Enum
string
ErrorWarning
object
The error in textual format.
12 properties
Geolocation
object
Used to specify the geographic coordinates of a location.
6 properties
Result
object
5 properties
1 required
Address
object
12 properties
1 required
AddressDetail
Enum_AddressRole
object
2 properties
Enum_AddressRole_Base
string
Enum_AddressRole_Open
string
Location
object
4 properties
2 required
IndexPointCode_Enum
string
Indicates the type of location being referenced (e.g., Airport, Hotel).
Email
object
9 properties
2 required
MultimediaCollection
object
4 properties
2 required
VideoCategoryID
object
4 properties
1 required
VideoCategory
MultimediaDescription
object
6 properties
2 required
MultimediaDetails
object
Warning: To be redesigned in the next release. The title of the multimedia object.
10 properties
VideoID
object
4 properties
1 required
Video
Rating
object
The actual award or rating received by the facility.
7 properties
OperationSchedule
object
8 properties
1 required
RateRange
object
A range of monetary values within which the cost of the available products are requested.
5 properties
Radius
object
The radius distance.
2 properties
LocationCode
object
Location code is city, stateProvence, or country code
5 properties
ImageID
object
4 properties
1 required
Image
ImageCategory
object
7 properties
1 required
RelativePosition
object
14 properties
1 required
Directions
object
14 properties
1 required
TransportationID
object
4 properties
1 required
Transportation
Transportations
object
3 properties
1 required
ArrivalTransport
object
3 properties
1 required
DepartureTransport
object
3 properties
1 required
TextCategory
object
6 properties
1 required
FormattedTextSubSection
object
6 properties
2 required
Feature
object
5 properties
1 required
Ancillary
object
9 properties
1 required
Amenity
object
6 properties
1 required
ReferencePoint
object
6 properties
1 required
ReferencePointDetail
Dimensions
object
Defines the dimensions of an object.
5 properties
File
object
Properties of a file.
3 properties
Multimedia
object
10 properties
1 required
MultimediaImage
MultimediaText
MultimediaVideo
BaseResponse
object
4 properties
1 required
ContactInformation
object
9 properties
1 required
ExtensionPoint
ExtensionPoint_Detail
ExtensionPoint_Custom
ExtensionPoint_Query
ExtensionPoint_Update
ExtensionPoint_Choice
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from OpenTravel Alliance 3
Other APIs OpenTravel Alliance publishes across the network.
OpenTravel 2020A Hotel Descriptive Content Resource
OpenTravel 2018A Hospitality Offers Resource
OpenTravel 2018A Facility Resource
#Hospitality#Facilities#OpenTravel 2.0
Where this information came from
This is an independent, third-party profile of OpenTravel 2020A Facility Resource, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.