---
title: "List partners available for hotel ID mapping"
method: GET
path: "/hotels/match/partners"
tags: ["Hotel Match"]
---

# List partners available for hotel ID mapping

`GET /hotels/match/partners`

## Request

- Base URL: `https://api.liteapi.travel/v3.0`
- URL: `https://api.liteapi.travel/v3.0/hotels/match/partners`
- Auth: API key in header `X-API-Key`

## Overview

Returns every partner that can be used for hotel ID mapping, along with each partner's inventory coverage size (`mappings`). Use this list to discover which partner inventories can be aligned with Nuitee / liteAPI hotel IDs.

Hotel mapping connects a partner's hotel identifiers to Nuitee catalogue IDs so you can shop, book, and enrich content against a single inventory.

## When to Use

- **Before mapping IDs** - Confirm the partner name to pass into `POST /hotels/match/partners/with-id`
- **Coverage checks** - Compare `mappings` counts to estimate how much of a partner's inventory is already linked
- **Partner selectors** - Populate UI or automation dropdowns with supported partners
- **Onboarding** - Discover which OTAs / suppliers are available for ID-to-ID mapping

## What You Get

- **Partner names** - Exact strings to send as the `partner` form field on the map endpoint
- **Inventory size** - `mappings` count per partner (known ID links in the mapping catalogue)
- **Sorted list** - Partners ordered by mapping count, descending

## Key Features

- **No request body**: Simple authenticated GET
- **Case-insensitive partner names upstream**: Prefer the exact `partner` string from this response
- **Accounts without suppliers**: Allowed to call hotel mapping endpoints (standard auth still applies)

## Quick Start

1. Authenticate with your LiteAPI `X-API-Key`
2. Call `GET /hotels/match/partners`
3. Pick a `partner` value from the response
4. Upload that partner's hotel ID CSV to `POST /hotels/match/partners/with-id`

**Rate limit:** 50 requests/min (production), 10 requests/min (sandbox).

## Response `200`

Partner list with inventory mapping counts

- PartnersResponse
  - `partners` Partner[], required: Partners sorted by mapping count (descending)
    - `partner` string, required: Partner name. Pass this exact string as the `partner` form field when mapping IDs (matching is case-insensitive upstream).
    - `mappings` integer, required: Number of known ID mappings for this partner — a proxy for inventory coverage size.

## Other responses

- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal Server Error
- `502`: Upstream mapping service unreachable
- `504`: Upstream mapping service timed out

---

[API](https://skmtc.dev/liteapi/apis/api-mapping.md) - [All operations](https://skmtc.dev/liteapi/apis/api-mapping/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-mapping/revisions/82f8d27a93af?raw)