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.

get

returns all configured room rates for specified hotelier

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

pmsCodestring · min: 1Required

pmsCode used to identify the pmsx partner

hotelCodestring · min: 1Required

hotelCode used to identify the hotelier

Header parameters

X-SM-TRACE-TOKENstringRequired

traceToken is logged with every log messages for this request

Responses

200

OK

application/json

400

Invalid request

application/json

401

Unauthorized

application/json

429

Too Many Requests

application/json

500

Unexpected error occurred

application/json

get

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

HTTPcURLJavaScriptPython

GET /pmses/{pmsCode}/hotels/{hotelCode}/room-rates HTTP/1.1
Host: tpi-pmsx.preprod.siteminderlabs.com
Authorization: Basic username:password
X-SM-TRACE-TOKEN: text
Accept: */*

[
  {
    "ratePlanName": "text",
    "ratePlanCode": "text",
    "roomTypeName": "text",
    "roomTypeCode": "text",
    "includedAdultOccupancy": 1
  }
]

Common Questions

What is the difference between RoomTypeCode and InventoryTypeCode?

Both identify the same room type, just used in different message types:

• InvTypeCode = Used to identify the room type in inventory updates (availability, restrictions, rates)

• RoomTypeCode = Used to identify the room type in reservations messages

Use the roomTypeCode from the room-rates endpoint for both.

Can I use the room-rates endpoint with hotel-level authentication?

No. The room-rates endpoint requires PMS-level authentication (same credentials for all properties).

If you're using hotel-level authentication, contact Partner Integrations to migrate to PMS-level.

How often should I call the room-rates endpoint?

During initial setup and when mapping changes occur.

This endpoint is for configuration retrieval, not real-time polling:

• Initial Integration: Pull room rates during PMS setup

• On Demand: When mapping issues are reported or rooms/rates are added

• Periodic Sync: Optional weekly or monthly check for configuration updates

Avoid polling frequently, room rate configurations don't change often.

Help Centre

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