---
title: "Get promotion listings"
method: GET
path: "/rm-promotions/promotions/{promotionId}/listings"
tags: ["Promotions Open Api"]
---

# Get promotion listings

`GET /rm-promotions/promotions/{promotionId}/listings`

## Request

- Base URL: `https://open-api.guesty.com/v1`
- URL: `https://open-api.guesty.com/v1/rm-promotions/promotions/{promotionId}/listings`
- Auth: API key in header `authorization`

Get listing IDs assigned to a promotion.

## Path parameters

- `promotionId` string, required

## Query parameters

- `includeChildren` boolean, required

## Response `200`

Returns listing IDs assigned to the promotion.

- object
  - `promotionId` string, required: ID of promotion.
  - `listingIds` string[], required: Listing IDs assigned to the promotion.
  - `limit` number, required: Maximum number of promotions that can be returned in the response.
  - `skip` number, required: Number of promotions that should be skipped from the result set.
  - `count` number, required: Number of listings in the result set.
  - `requestId` string, required: ID of request.

## Other responses

- `400`: Validation error.
- `401`: Authorization error.
- `403`: Feature is not enabled for this accountId.
- `404`: Promotion was not found.
- `500`: Internal server error.

---

[API](https://skmtc.dev/guesty/apis/guesty-open-api.md) - [All operations](https://skmtc.dev/guesty/apis/guesty-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/guesty/apis/guesty-open-api/revisions/3122b8618183?raw)