# List a listing's links to other booking platforms.

`GET /listings/{listing_id}/ota_links`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-ota-links · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetOtaLinks` · Tag: Listing OTA Links

Returns the listing's pages on other booking platforms and its direct booking website, each once with every source that links it, plus the listing's own page on the channel it is connected through when that has a URL.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/ota_links`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | string | yes | The channel's unique listing identifier, or the Wheelhouse listing ID when `channel` is `wheelhouse`. |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `channel` | string | yes | Channel name the listing is on (the `channel` field of the [/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-listings.md) response), or the literal `wheelhouse` to read `listing_id` as a Wheelhouse listing ID instead. See [Identifying Listings](https://docs.usewheelhouse.com/rm/concepts/listings.md). |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/ota_links?channel=<channel>' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

The listing's links.

Body (`application/json`): array of object `ota_link_response`

A page on another booking platform, or the listing's direct booking website, with every source that links the listing to it.

- `platform` (string, required, nullable, one of: `airbnb`, `booking_com`, `direct`, `vrbo`, `null`): The platform the page is on, as `PUT /listings/{listing_id}/ota_links` takes it. `null` only for the listing's own page on a channel that is none of these.
- `platform_name` (string, required, nullable): Display name of the platform, e.g. `Airbnb`, `Vrbo`, `Booking.com` or `Direct Website`.
- `external_id` (string, required, nullable): The platform's ID for the page, e.g. the Airbnb room ID. For a Booking.com page added by URL it is the country and slug from the URL (`US/cloud-nine`). For `direct`, the URL itself.
- `url` (string, required, nullable): The page's URL. `null` when no source gave one and Wheelhouse has no data for the page, e.g. a Booking.com hotel ID from the PMS.
- `title` (string, required, nullable): The page's title on that platform, or `null` when Wheelhouse has no data for the page.
- `own_listing` (boolean, required): `true` for the listing's own page on the channel it is connected through. It is listed even when no source links it, with an empty `sources`.
- `known` (boolean, required): Whether Wheelhouse has data for the page. A newly added page can take a while to become known. Always `true` for `direct`.
- `page_active` (boolean, required, nullable): Whether the page is still listed on the platform, or `null` when unknown.
- `sources` (array of object `ota_link_source`, required): Every source that links the listing to the page, oldest first.
  - Each item: One source that links the listing to the page.
  - `link_id` (integer, required, example: `48213`): Identifies this source's link. Pass it to `DELETE /listings/{listing_id}/ota_links/{link_id}`.
  - `source` (string, required, one of: `pms`, `user`, `bulk`): `pms` when the listing's PMS sent the link, `user` when a user added it in Wheelhouse or through this API, `bulk` when it came from a bulk upload.
  - `since` (string (date-time), required): When this source first linked the page.
  - `removable` (boolean, required): Whether `DELETE /listings/{listing_id}/ota_links/{link_id}` can remove this source's link. Links from the PMS cannot be removed.

Example shape (generated from the schema; placeholder values, not a real response):

```json
[
  {
    "platform": "airbnb",
    "platform_name": "string",
    "external_id": "string",
    "url": "string",
    "title": "string",
    "own_listing": true,
    "known": true,
    "page_active": true,
    "sources": [
      {
        "link_id": 48213,
        "source": "pms",
        "since": "2026-01-01T00:00:00Z",
        "removable": true
      }
    ]
  }
]
```

### 401

API key authorization failed.

### 403

Listing authorization failed.

### 404

Listing not found.

### 406

The listing is inactive. See the **Inactive Listings** section in the overview.

Body (`application/json`): object

- `error` (string, example: `Listing '12345' is inactive`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "Listing '12345' is inactive"
}
```

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
