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

# GET promotion

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

## Request

- Base URL: `https://api.bookingexperts.com`
- URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/promotions/{id}`
- 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/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the promotion for the given ID

## Path parameters

- `administration_id` string, required
- `id` string, required

## Query parameters

- `fields[promotion]` string

## Headers

- `Accept-Language` string

## Response `200`

PromotionResponse

- object
  - `data` Promotion: Promotions are used to advertise discount actions on rent prices for one or more RentableTypes. Discounts can be a percentage or a fixed amount.
    - `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.

## 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/:id/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)