Endpoints for searching and retrieving product details.
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.
- 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
Overview
URL
BeMyGuest API Support
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/
Product Summary
This is the summary view of a Product object that is returned in the /products endpoint
{ "uuid": "d5a03ea2-e06e-5d01-84b7-94530b1059f7", "updatedAt": "2020-03-13 17:31:00", "title": "Universal Studios Singapore E-ticket (Test)", "titleTranslated": "新加坡环球影城电子门票（测试）", "validFrom": "2024-01-01", "validThrough": "2024-02-01", "basePrice": 69.13, "typeName": "Attraction", "typeUuid": "d3c54653-dd05-598f-b193-f6683d1064ab", "links": [ { … } ] }
ProductType
The full ProductType Details information object
How many days in advance booking can be made. NULL if not applicable
Maximum number of group: sum of adults, children and senior or null when not applicable
Minimum number of group: sum of adults, children and senior or null when not applicable
TRUE then confirmed booking this product should return new Booking status = approved, but if we're out of stock of e-tickets it can still return a 'Waiting' status
TRUE, the voucher allows direct admission, otherwise customer needs to redeem vouchers. Information about voucher redemption is showed in voucherUse and voucherRedemptionAddress
Voucher redemption address if client needs to redeem a voucher.
Default "null"
voucherRedemptionAddress translated on requested language.
Default "null"
TRUE voucher needs to be printed. Otherwise, it can be presented eg. on mobile device
Translated version of meetingLocation on requested language
Default "null"
List of all ticket types for this product type
Available timeslots for product, might be null. If the ProductType has timeslots, the timeslotUUID of the product is REQUIRED in Check a Booking and Create a new booking methods
Booking options
Options per booking array
Options that are required/available for each person on the booking
true/false, indicate whether product type has booking option that require file upload
true/false, indicate whether product type has booking option which has a price.
true/false, indicate whether product type has booking option which has a price and required is TRUE
First date that is available for booking. 'False' if there is no availability date Use calendar endpoint to check availability
Is an adult allowed to book this product type true/false. Use the ticketTypes object for this information
Minimum number of adults. NULL if not applicable. Use the ticketTypes object for this information
Maximum number of adults. NULL if not applicable. Use the ticketTypes object for this information
Minimum age allowed for an adult. NULL if not applicable. Use the ticketTypes object for this information
Maximum age allowed for an adult. NULL if not applicable. Use the ticketTypes object for this information
Minimum number of children or null when not allowed. NULL if not applicable. Use the ticketTypes object for this information
Maximum number of children or null when not allowed. NULL if not applicable. Use the ticketTypes object for this information
Minimum age allowed for a child. NULL if not applicable. Use the ticketTypes object for this information
Maximum age allowed for a child. NULL if not applicable. Use the ticketTypes object for this information
Is a senior allowed to book this product type. Use the ticketTypes object for this information
Minimum number of seniors. NULL if not applicable. Use the ticketTypes object for this information
Maximum number of senior. NULL if not applicable. Use the ticketTypes object for this information
Minimum age allowed for a senior. NULL if not applicable. Use the ticketTypes object for this information
Maximum age allowed for a senior. NULL if not applicable. Use the ticketTypes object for this information
Recommended markup to adult prices if you want to match with BMG's recommended prices (RRP). Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
Recommended markup for child prices if you want to match with BMG's recommended prices (RRP). Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
Recommended markup for senior prices if you want to match with BMG's recommended prices (RRP). Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
Minimal retail price for adult. Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
Minimal retail price for child. Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
Minimal retail price for senior. Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
The rate that an adult get directly at the attraction website or gate. Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
The rate that a child get directly at the attraction website or gate. Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
The rate that a senior get directly at the attraction website or gate. Null if not applicable. Use either the calendar endpoint or price-list endpoint to check pricing
{ "uuid": "d11b9919-4da2-5a4c-bcea-c3b9f688cc62", "title": "River Safari Admission with Two Boat Rides", "titleTranslated": "River Safari Admission with Two Boat Rides", "description": "description.... descriptions....", "descriptionTranslated": "descriptions...descriptions....", "durationDays": 0, "durationHours": 8, "durationMinutes": 0, "daysInAdvance": 1, "cutOffTime": "17:00", "firstAvailabilityDate": "2024-01-20", "isNonRefundable": true, "allowAdults": true, "minPax": 1, "maxPax": 10, "minAdultAge": 13, "maxAdultAge": 60, "hasChildPrice": true, "allowChildren": true, "minChildren": 0, "maxChildren": 10, "minChildAge": 6, "maxChildAge": 12, "allowSeniors": true, "minSeniors": 0, "maxSeniors": 10, "minSeniorAge": 61, "maxSeniorAge": 90, "allowInfant": true, "minInfantAge": 0, "maxInfantAge": 2, "maxGroup": 5, "minGroup": 2, "instantConfirmation": true, "nonInstantVoucher": false, "directAdmission": true, "voucherUse": "instruction..instruction....", "voucherUseTranslated": "how to use....how to use....", "voucherRedemptionAddress": "redeem here....redeem here....", "voucherRedemptionAddressTranslated": "redeem here...redeem here....", "voucherRequiresPrinting": false, "meetingTime": "13:00", "meetingAddress": "This address...this address", "meetingLocation": "Meet here....meet here...", "meetingLocationTranslated": "Meet here....meet here....", "cancellationPolicies": [ { … }, { … } ], "cancellationPolicySummary": "Cancellation of at least 48 hrs before arrival: 100% refund\\nCancellation between 48 hrs and 24 hrs before arrival: 10% refund\\nExtra cancellation or refund fees may apply. Any cancellations falling outside of the above policy are strictly non-refundable", "recommendedMarkup": 66.67, "childRecommendedMarkup": 66.67, "seniorRecommendedMarkup": 66.67, "adultParityPrice": 60, "childParityPrice": 60, "seniorParityPrice": 60, "adultGateRatePrice": 80, "childGateRatePrice": 80, "seniorGateRatePrice": 80, "ticketTypes": [ { … }, { … }, { … }, { … }, { … } ], "validity": { "type": "only_visit_date", "days": null, "date": null, "hasBatchValidityDate": false }, "timeslots": [ { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … } ], "timezone": "Europe/Berlin", "options": { "perBooking": [ … ], "perPax": [ … ] }, "hasOptions": true, "hasFileUploadOptions": false, "hasPriceOptions": false, "hasRequiredPriceOptions": false, "isBmgVoucher": false, "isSrvEligible": false }