Rooms and Rates

Retrieve room type and rate plan configurations to map your PMS inventory with the SiteMinder Platform.

What is Rooms and Rates

Rooms and Rates is a retrieval method where the Property Management System (PMS) requests a list of configured room types and rate plans from the SiteMinder Platform. This integration ensures that the PMS can properly map its internal room and rate structures with the configurations set up for distribution across all connected channels, maintaining accurate inventory, pricing and reservation synchronization.

Considerations

• Configuration Scope: The room-rates endpoint returns only the room rates configured for the PMS on the SiteMinder Platform. This configuration is managed through Distribution > Connectivities > {PMS Name} > Rooms and Rates Mapping.

• Rate Plan Support: If your PMS does not support Rate Plans, the fields for ratePlanName and ratePlanCode will be empty in the response.

• Optional Fields: The includedAdultOccupancy field is optional and may be blank if hoteliers have not set this included occupancy value on the SiteMinder Platform.

• Code Mapping: The roomTypeCode returned by the room-rates endpoint must be used for both RoomTypeCode and InvTypeCode on the PMS side to ensure consistent inventory and reservation mapping.

Authentication Requirements: The REST components of the pmsXchange API only support PMS-level authentication, which means using the same credentials across all properties. If you’re currently using hotel-level authentication (credentials per property), we recommend switching to PMS-level to ensure compatibility with the REST endpoints.

Retrieve room rate mappings for a hotel

get

Returns the current room rate mapping configuration for the specified hotel

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

hotelCodestringRequired

Hotel identifier code

pmsCodestringRequired

PMSX partner code

Header parameters

X-SM-TRACE-TOKENstringRequired

The unique identifier of the request (UUID), this traceToken is logged with this request.

Example: 8bf21e96-e6c7-4bf9-a377-a5763e053538

Responses

200

PMS RoomRate Mapping Response

application/json

400

Bad request

application/json

401

Unauthorized

application/json

403

Access Denied

application/json

404

Not Found

application/json

429

Too Many Requests

500

Internal server error

application/json

503

Service Unavailable

application/json

get

/pmses/{pmsCode}/hotels/{hotelCode}/room-rates

HTTPcURLJavaScriptPython

GET /pmses/{pmsCode}/hotels/{hotelCode}/room-rates HTTP/1.1
Host: pmsx-partner.com
Authorization: Basic username:password
X-SM-TRACE-TOKEN: 8bf21e96-e6c7-4bf9-a377-a5763e053538
Accept: */*

[
  {
    "roomTypeCode": "ABC",
    "ratePlanCode": "CBA",
    "roomTypeName": "Single Room",
    "ratePlanName": "Best Available Rate",
    "includedAdultOccupancy": 2,
    "rateSetupType": "Derived",
    "unsupportedData": [
      {
        "code": "NO_RATES"
      }
    ]
  }
]

Help Centre

• Map your room rates to your connected PMS/RMS/CRS