Developer Docs

Channel Manager API

Integrate your application with the Channel Manager platform to search rooms, create bookings, and update reservation status programmatically.

Base URL https://mdshotelcloud.com/cmapi/ChannelManager

Get Property Info

Retrieve full details of a property using its unique property ID (GUID).

GET /GetProperty/{propertyId}

Response

{
  "id": 0,
  "name": "string",
  "vatPercent": 0,
  "zipCode": "string",
  "city": "string",
  "address": "string",
  "phone": "string",
  "fax": "string",
  "vatNumber": "string",
  "administrativeEmail": "string",
  "reservationsEmail": "string",
  "latitude": 0,
  "longitude": 0
}

Get Room Types by Property

Returns all room types configured for a given property ID.

GET /GetRoomTypesByProperty/{propertyId}

Response — Array

[
  {
    "id": 0,
    "roomTypeName": "string",
    "shortName": "string",
    "shortDescription": "string",
    "services": ["string"],
    "images": ["string"],
    "primaryImage": "string",
    "bannerImage": "string",
    "description": "string",
    "defaultPrice": 0,
    "defaultCurrency": 0,
    "defaultAvailableRooms": 0,
    "guests": 0,
    "kids": 0
  }
]

Get Room Type by ID

Retrieve detailed information about a specific room type using its property ID and room type ID.

GET /GetRoomTypeById/{propertyId}/{roomTypeId}

Response

{
  "id": 0,
  "roomTypeName": "string",
  "shortName": "string",
  "defaultPrice": 0,
  "defaultAvailableRooms": 0,
  "guests": 0,
  "kids": 0
}

Get Room Type by Name

Search for a room type by its name string within a specific property.

GET /GetRoomTypeByName/{propertyId}/{name}

Response — same shape as Room Type by ID

{
  "id": 0,
  "roomTypeName": "string",
  "defaultPrice": 0,
  "defaultAvailableRooms": 0
}

Get Room Types by Filter

Search available room types with check-in/check-out dates, guest count, and other criteria.

GET /GetRoomTypesByProperty/{propertyId}

Request Body

{
  "checkIn": "2024-09-15T20:03:01.933Z",
  "checkOut": "2024-09-18T20:03:01.933Z",
  "adults": 2,
  "child": 0,
  "room": 1,
  "propertyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Book a Room

Create a new booking. All fields are required. Room type ID and property ID are obtained from the Channel Manager platform.

POST /BookNow

Request Body

{
  "propertyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "roomTypeId": 0,
  "name": "string",
  "emailId": "string",
  "checkIn": "2024-09-18T09:40:06.262Z",
  "checkOut": "2024-09-21T09:40:06.262Z",
  "adults": 2,
  "kids": 0,
  "room": 1,
  "contact": "string",
  "roomShortName": "string",
  "bookingRefNo": "string",
  "defaultPrice": 0
}

Response

HTTP 201 Created

Update Booking Status

Update the payment status of an existing booking. All fields are required.

POST /UpdateBookingStatus

Request Body

{
  "bookingRef": "string",
  "status": 0,
  "paymentRef": "string",
  "totalPaid": 0
}