---
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`

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.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/revisions/7c62644070f2/schema)