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

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.

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

What You'll Receive from SiteMinder

When your integration begins, we'll send you an initiation email asking you to complete the Testing Setup form. This allows us to configure your access to the Partner Portal, where you'll generate your API ID and API Key.

Item	Details
Channel endpoint	https://tpi-channel-api.preprod.smchannelsplus.com/
Export endpoint	https://tpi-export-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

• Channels Plus Export API — 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'

Use SiteMinder's shared test credentials to make this call:

• API ID: c258d726-e6fa-47a3-9ae8-e0290484bbe4

• API KEY: b7d92948-5b0b-4b38-a08e-f1c53eff2947

• Credentials are pre-filled in the Postman collection below.

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.

---

Explore with Postman

SiteMinder's Channels Plus Postman workspace contains collections and environments to help you build, test, and validate your integration for certification. Fork the collections and environments to your own Postman account to get started.

→ Channels Plus Postman Workspace

Shared Test Credentials

The Channels Plus - API TEST environment is pre-filled with shared test credentials. You can use these immediately — no dedicated test account required — to test.

Shared credentials cover Properties and Property endpoints only. Reservations and Export require your dedicated test account credentials. Update the environment variables with your credentials once your test environment is set up.

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.