Quick Start

Everything you need to begin building with Channels Plus API.

Channels Plus connects your booking channel with SiteMinder's distribution platform. Through Channels Plus, your channel can search for available properties, retrieve room and rate details, and manage bookings.

API components:

• Properties: Search and retrieve property details

• Property: Availability, pricing, and room configuration

• Reservations: Create, modify, and cancel reservations

• Deals: Negotiate competitive rates with properties

Explore all components in the API Overview.

---

Before You Begin

Partnership Required

Access to Channels Plus requires an active partnership agreement with SiteMinder. Once your agreement is in place, you will receive your test environment details.

Become a SiteMinder Partner

You don't need to wait for your test environment to start development. You can begin building and testing immediately. See Make Your First Call below or explore requests directly in the Postman collection.

What You'll Receive from SiteMinder

SiteMinder will provide the following to get you started:

Item	Details
REST endpoint	https://tpi-channel-api.preprod.smchannelsplus.com
Partner Portal	Access to generate your API ID and API Key, and to create Deals

Set Up Your Environment

Authentication

Channels Plus uses channel-level authentication — two headers on every request (API ID and API Key), both generated from the Partner Portal.

--header 'x-sm-api-id: YOUR_API_ID' \
--header 'x-sm-api-key: YOUR_API_KEY'

Keep your API ID and API Key private. Never expose them in front-end or client-side code. This API is for server-to-server use only.

API Specification File

REST (OpenAPI)

• Channels Plus — download YAML

---

Make Your First Call

The first call every Channels Plus integration must implement is Get Properties — your channel retrieves a list of available properties from SiteMinder based on location and date criteria.

1

Authenticate

Pass your API ID and API Key as headers on every request:

--header 'x-sm-api-id: YOUR_API_ID' \
--header 'x-sm-api-key: YOUR_API_KEY'

2

Make the call

Retrieve available properties by location and date:

curl -L \
  --url 'https://tpi-channel-api.preprod.smchannelsplus.com/properties?latitude=1&longitude=1&checkin=2026-04-07&checkout=2026-04-07' \
  --header 'x-sm-api-id: YOUR_API_ID' \
  --header 'x-sm-api-key: YOUR_API_KEY' \
  --header 'Accept: */*'

3

Handle the response

A successful response returns an array of properties matching your search criteria, each including room types, rate plans, pricing, and commission details:

[
  {
    "uuid": "text",
    "name": "text",
    "propertyType": { "text": "text", "language": "text" },
    "address": "text",
    "country": "text",
    "latitude": 1,
    "longitude": 1,
    "starRating": 1,
    "currency": "text",
    "totalCommissionPercentage": 1,
    "rooms": [
      {
        "roomRateUuid": "text",
        "ratePlanName": "text",
        "adults": 1,
        "cancellationPolicy": {
          "policyType": "non-refundable",
          "freeCancellationUntilDays": 1
        },
        "prices": [
          {
            "totalPrice": 1,
            "dealCode": "text",
            "totalCommissionPercentage": 1
          }
        ]
      }
    ]
  }
]

4

Handle errors

If your API ID or API Key is missing or invalid:

{
  "errors": [
    {
      "code": "text",
      "message": "text",
      "meta": {}
    }
  ]
}

401 - Check your x-sm-api-id and x-sm-api-key headers are correct and present on every request.

{
  "errors": [
    {
      "code": "text",
      "message": "text",
      "meta": {}
    }
  ]
}

429 - The number of requests for the last 5 minutes has reached the limit for your channel. Wait before retrying.

---

Create a Deal

Deals allow your channel to negotiate competitive rates directly with properties, giving your customers access to exclusive pricing.

To set up your first deal:

1. Log in to the Partner Portal

2. Create a deal using a test property

3. Notify the Partner Integrations team once your deal is ready for approval

4. Once approved, use the dealCode returned in the properties response to apply the negotiated rate in your requests

For full details on the Deals feature, see Deals.

---

Explore with Postman

Fork SiteMinder's Channels Plus Postman workspace to run requests with pre-configured environments.

→ Channels Plus Postman Workspace

Your credentials

Update the Postman environment with your credentials from the Partner Portal before running any collection:

Variable	Value
API ID	Your API ID from the Partner Portal
API Key	Your API Key from the Partner Portal

For full certification scenario coverage, see Testing and Certification.

Still have questions?

Use the Ask button at the top of the page to chat with our AI assistant — it can help you navigate the guide, understand requirements, and troubleshoot issues.

If you need more support, visit Integration Support.