Skip to content

BeMyGuest API v2.0 (2.1)

The BeMyGuest API is the industry benchmark preferred by online travel agents, designed solely for Asia's attractions, tours and activities. This comprehensive API provides real-time access to a vast inventory of travel products.

Key Features:

  • Product Discovery: Search and retrieve detailed information for a wide range of travel products, including attractions, tours, and activities.
  • Real-Time Availability and Pricing: Check live availability and get up-to-date pricing for specific product types and dates.
  • End-to-End Booking Management: Create, confirm, and cancel bookings seamlessly.
  • Voucher Retrieval: Access and download booking vouchers directly through the API.
  • Configuration: Fetch essential configuration data such as supported languages, currencies, and locations to customize your integration.
Download OpenAPI description
Languages
Servers
Mock server

https://docs.bemyguest.com.sg/_mock/openapi/

Api Demo Server

https://api.demo.bemyguest.com.sg/

Api Production Server

https://api.bemyguest.com.sg/

Products

Endpoints for searching and retrieving product details.

Operations

Product-Types

Endpoints for retrieving product type information, pricing, and availability.

Operations

Bookings

Endpoints for creating and managing bookings.

Operations

Configuration

Endpoints for retrieving API configuration data.

Operations

Requests

Schemas that define requests.

Responses

Schemas that define API responses.

Webhooks

Price Detail

idstring(uuid)
Example: "cb57b5c6-376c-47f5-ad09-606d6850f5e1"
ratesArray of objects(RateDetail)
rates[].​amountnumber
Example: 98
rates[].​categorystring
Example: "adult"
rates[].​currencystring
Example: "SGD"
rates[].​formatstring
Example: "S$98.00"
rates[].​metaobject or Array of arrays
Example: {"markup":16.8639}
One of:
object
rates[].​type"nettPrice" (string) or "retailPrice" (string) or "recommendedPrice" (string) or "minimumSellingPrice" (string)(PriceTypes)
One of:
string("nettPrice")
{ "id": "cb57b5c6-376c-47f5-ad09-606d6850f5e1", "rates": [ {} ] }

PriceTypes

One of:
string("nettPrice")
"nettPrice"

Product

Full version of a Product's Details

additionalInfostring
additionalInfoTranslatedstring
addressstring

Address of the location of the attraction

allProductTypesHaveOptionsboolean

true/false, when all product types of product have options.

airportPickupboolean

true/false, Depreciated. When airportPickup is true, customer need to provide airport information. This value has been depreciated. It may be appear as booking option instead.

averageDeliverynumber

Average time (in seconds) that is needed to process the booking

audioHeadsetLanguagesArray of objects(Language)

Available languages for Audio Headset material

audioHeadsetLanguages[].​namestringrequired
audioHeadsetLanguages[].​codestring
audioHeadsetLanguages[].​uuidstringrequired
basePricenumber

Base price of product

businessHoursFromstring

supplier business hours from

businessHoursTostring

supplier business hours to

categoriesArray of objects

Array of categories

currencyobject

Currency

descriptionstring

Description of product. Always in English

descriptionTranslatedstring

Description of product on requested language

hasOptionsboolean

true/false, when at least one product type of this product has options.

highlightsstring

Highlights of product. Always in English

highlightsTranslatedstring

Highlights of product on requested language

hotelPickupboolean

true/false, Depreciated. When hotelPickup is true, customer need to provide hotel name and address. This value has been depreciated. It may be appear as booking option instead

itinerarystring or null

Activity itinerary - only applicable for Package type, will be null for others

Default "null"
itineraryTranslatedstring or null

translated version of itinerary on requested language

Default "null"
latitudestring

Latitude of location

locationsArray of objects

Array product location information

longitudestring

Longitude of location

maxPaxintegerint32

Maximum number of pax (adults)

minPaxintegerint32

Minimum number of pax (adults)

photosArray of objects

Array of photos in different dimensions (Sizes: original, 75x50, 175x112, 680x325). Please download the images to your platform. DO NOT hotlinking to these images

photosUrlstring

images base url

priceIncludesstring

What's included in product price

priceIncludesTranslatedstring

priceIncludes on requested language

reviewAverageScorenumber

Average review score

reviewCountintegerint32

Number of reviews

safetystring or null

activity safety information

Default "null"
safetyTranslatedstring or null

translated version of safety information on requested language

Default "null"
titlestring

Title of product. Always in English

titleTranslatedstring

Title of product on requested language

tourTypestring or null

Tour type of product private/join/null

Default "null"
typeNamestring

Type of product

translationLanguagesArray of objects(Language)

Available translated languages for product.

translationLanguages[].​namestringrequired
translationLanguages[].​codestring
translationLanguages[].​uuidstringrequired
updatedAtstring

last update date/time to product

uuidstring(uuid)

UUID of product

validFromstring or null

Start date for product availability (or null when no limit)

Default "null"
validThroughstring or null

End date if product availability (or null when no limit)

Default "null"
warningsstring or null

Warnings of the activity (related to safety and insurance)

Default "null"
warningsTranslatedstring or null

translated version of warnings on requested language

Default "null"
writtenLanguagesArray of objects(Language)

Available written languages for reading material.

writtenLanguages[].​namestringrequired
writtenLanguages[].​codestring
writtenLanguages[].​uuidstringrequired
covid19Measuresstring or nullDeprecated

Information on Covid-19 notice of Safety Standards of visiting the attractions

Default "null"
covid19MeasuresTranslatedstring or nullDeprecated

Information on Covid-19 notice of Safety Standards of visiting the attractions on requested language

Default "null"
isFlatPaxPricebooleanDeprecated

true/false (An indication to tell if the Product has the same price for each pax in all of its productTypes)

isSrvEligiblebooleanDeprecated

true/false. indicate whether this product is available for Singapore Rediscover Vouchers Promo.

Default false
{ "additionalInfo": "string", "additionalInfoTranslated": "string", "address": "Gateway Ave, Singapore", "allProductTypesHaveOptions": false, "airportPickup": false, "averageDelivery": 64, "audioHeadsetLanguages": [], "basePrice": 69.13, "businessHoursFrom": "10:00", "businessHoursTo": "20:00", "categories": [ {} ], "covid19Measures": "no information", "covid19MeasuresTranslated": "no information", "currency": { "code": "SGD", "symbol": "S$", "uuid": "cd15153e-dfd1-5039-8aa3-115bec58e86e" }, "description": "Experience different cutting-edge rides, shows, and attractions based on your favourite blockbuster films and television series at Universal Studios Singapore. This skip-the-line e-ticket will let guests have access to the seven zones of the park, including Hollywood, New York, Sci-Fi City, Ancient Egypt, Lost World, Far Far Away, and Madagascar.\\r\\n\\r\\nIn Hollywood, ticket holders can try rollercoasters and other movie-themed attractions.", "descriptionTranslated": "在新加坡环球影城体验基于您最喜爱的大片和电视剧的不同尖端游乐设施、表演和景点。这张免排队电子门票将让游客可以进入公园的七个区域,包括好莱坞、纽约、科幻城、古埃及、失落的世界、遥远之地和马达加斯加。\\r\\n \\r\\n在好莱坞,持票者可以尝试过山车和其他电影主题的景点。", "hasOptions": false, "highlights": "Experience cutting-edge rides, shows, and attractions at Universal Studios Singapore\\nVisit the seven themed zones of the park like Ancient Egypt, Lost World, and Madagascar\\nMeet your favourite movie and TV characters like Shrek, Puss in Boots, and the Madagascar gang", "highlightsTranslated": "在新加坡环球影城体验尖端的游乐设施、表演和景点\\n参观公园的七个主题区,如古埃及、失落的世界和马达加斯加\\n认识你最喜欢的电影和电视角色,如怪物史莱克、穿靴子的猫和马达加斯加帮派", "hotelPickup": false, "isFlatPaxPrice": true, "isSrvEligible": false, "itinerary": "no itinerary", "itineraryTranslated": "no itinerary", "latitude": "1.2544975", "locations": [ {} ], "longitude": "103.8251792", "maxPax": 10, "minPax": 1, "photos": { "$ref": "#/components/examples/PhotoList" }, "photosUrl": "https://s3.amazonaws.com/playground.bemyguest.com.sg", "priceIncludes": "Admission fee", "priceIncludesTranslated": "入场费", "reviewAverageScore": 4, "reviewCount": 1, "safety": "no information", "safetyTranslated": "no information", "title": "Universal Studios Singapore E-ticket (Test)", "titleTranslated": "新加坡环球影城电子门票(测试)", "tourType": "join", "typeName": "Attraction", "translationLanguages": [ {}, {}, {} ], "updatedAt": "2020-03-13 17:31:00", "uuid": "d5a03ea2-e06e-5d01-84b7-94530b1059f7", "validFrom": "2020-01-01", "validThrough": "2024-01-20", "warnings": "- The park shall remain operational in case of light rains. The decision to proceed is up to the ticket holder.\\r\\n\\r\\nSafety and insurance:\\r\\n- Children below 12 years old must be accompanied by a paying adult at all times.\\r\\n- Detailed information about ride restrictions can be found at the Guest Services Windows located at the front part of the park. It is also available at the Guest Services Lobby inside the park.", "warningsTranslated": "- 若遇小雨,公园将照常开放。是否继续进行的决定取决于持票人。\\r\\n\\r\\n安全和保险:\\r\\n- 12 岁以下儿童必须始终由付费成人陪同。\\r\\n- 详细信息有关乘车限制的信息,请前往位于公园前部的游客服务窗口。您也可以在公园内的宾客服务大厅购买。", "writtenLanguages": [] }