---
title: "Get All Promotions"
method: GET
path: "/rm-promotions/promotions"
tags: ["Promotions Open Api"]
---

# Get All Promotions

`GET /rm-promotions/promotions`

Retrieves all eligible, ongoing, and expired promotions on the account.

## Response `200`

Returns a list of all promotions on the account.

- object
  - `results` object[], required — List of promotion results.
    - `_id` object — The MongoDB ID of the promotion.
    - `name` string, required — Name of the promotion.
  - `count` number, required — Number of promotions in the result set.
  - `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.
  - `requestId` string, required — ID of request.

## Other responses

- `400` — Validation error.
- `401` — Authorization error.
- `403` — Feature is not enabled for this accountId.
- `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/versions/7c62644070f2/schema)