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
openapi.json
openapi.yaml
Overview
URL

https://www.bemyguest.com.sg/contact-us

BeMyGuest API Support

support@bemyguest.com.sg

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.

CreateBookingRequest

messagestring

message to host

productTypeUuidstring(uuid)

UUID of product type

customerobject(Booking Customer)

Booking person contact data

customer.​emailstringrequired

email

customer.​firstNamestringrequired

First name - accepts alphabets, spaces, hyphen and apostrophe only

customer.​lastNamestringrequired

Last name - accepts alphabets, spaces, hyphen and apostrophe only

customer.​phonestringrequired

Phone number

customer.​salutationstringrequired

Salutation

adultsintegerint32

Number of adults, can be 0 when minPax = 0

childrenintegerint32

Number of children

seniorsintegerint32

Number of seniors

timeSlotUuidstring(uuid)

UUID of timeslot. If timeslots provided.

arrivalDatestring(date)

Date

partnerReferencestring

Your own id of booking

optionsobject

Structure of a booking options object as used when creating a new booking

options.​perBookingArray of objects(BookingOptionValue)>= 0 itemsrequired

Options per booking array

options.​perBooking[].​uuidstring
options.​perBooking[].​valuestring or number
options.​perPaxArray of objects(BookingOptionsPerPax)>= 0 itemsrequired
Array [
options.​perPax[][].​uuidstring
options.​perPax[][].​valuestring or number
]
{
  "message": "If you need to call, please consider we are in European time zone",
  "productTypeUuid": "efedb1fc-f150-5eaa-bf6e-fc202f6114bd",
  "customer": {
    "email": "example@bemyguest.com.sg",
    "firstName": "Example",
    "lastName": "Customer",
    "phone": "+65 0000 0000",
    "salutation": "Mr."
  },
  "adults": 1,
  "children": 0,
  "seniors": 0,
  "timeSlotUuid": "cd15153e-dfd1-5077-8aa3-115bec58e86e",
  "arrivalDate": "2018-03-10",
  "partnerReference": "OUR_BOOKING_NO_001",
  "options": {
    "perPax": [ … ],
    "perBooking": []
  }
}

Responses

Schemas that define API responses.

webhooks

Webhooks