---
title: "GET promotions"
method: GET
path: "/v3/administrations/{administration_id}/promotions"
tags: ["Promotions"]
---

# GET promotions

`GET /v3/administrations/{administration_id}/promotions`

## Request

- Base URL: `https://api.bookingexperts.com`
- URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/promotions`
- Auth: one of:
  - API key in header `X-API-KEY`
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token`
- TypeScript: <https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/docs/v3/administrations/:administration_id/promotions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns promotions of the administration

## Path parameters

- `administration_id` string, required

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `sort` string
- `fields[promotion]` string
- `filter[id]` string
- `filter[name]` string
- `filter[description]` string
- `include_archived` boolean

## Headers

- `Accept-Language` string

## Response `200`

PromotionCollectionResponse

- object
  - `data` Promotion[]
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `name` object
        - `cs` string
        - `da-DK` string
        - `de` string
        - `de-AT` string
        - `de-CH` string
        - `en-US` string
        - `en-GB` string
        - `es` string
        - `fr` string
        - `fr-BE` string
        - `fr-LU` string
        - `it` string
        - `nb` string
        - `nl` string
        - `nl-BE` string
        - `pl` string
        - `pt` string
        - `tr` string
        - `en` string
        - `da` string
      - `description` object
        - `cs` string
        - `da-DK` string
        - `de` string
        - `de-AT` string
        - `de-CH` string
        - `en-US` string
        - `en-GB` string
        - `es` string
        - `fr` string
        - `fr-BE` string
        - `fr-LU` string
        - `it` string
        - `nb` string
        - `nl` string
        - `nl-BE` string
        - `pl` string
        - `pt` string
        - `tr` string
        - `en` string
        - `da` string
      - `rules` object: Yields the rules to which a new booking must apply.
        - `start_date` string, date
        - `end_date` string, date
        - `minimum_number_of_nights` integer
        - `maximum_number_of_nights` integer
        - `early_bird_minimum_number_of_days_in_advance` integer
        - `last_minute_maximum_number_of_days_in_advance` integer
      - `start_date` string, date
      - `minimum_stay_duration` integer
      - `suggested_guest_group` object
        - `seniors` integer
        - `adults` integer
        - `adolescents` integer
        - `children` integer
        - `babies` integer
        - `pets` integer
      - `banner` object
        - `original` string
        - `banner` string
        - `large` string
        - `polaroid` string
        - `thumb` string
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `meta` object
    - `pagination` object
      - `total_records` integer
      - `page` integer
      - `size` integer

## Other responses

- `429`: Error
- `default`: Error

## Changes

- **2026-11-03** `ff81bc4fefa9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/administrations/:administration_id/promotions/get.md)

---

[API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)