---
title: "List public promotions"
url: "https://portal.konghotels.cloud/apis/kong-hotels-partner-api-1/versions/23cc133a-2f87-4d55-9490-0b8b2bb7dd78/operations/listPromotions"
---

> Full API specification: https://portal.konghotels.cloud/apis/kong-hotels-partner-api-1/versions/23cc133a-2f87-4d55-9490-0b8b2bb7dd78.md

# List public promotions

`GET` `/promotions`

Operation ID: `listPromotions`

Public promotions bookable today. Private codes (closed user groups) are not listed but can be looked up.

## Query parameters

- `property` (string, optional) - Only promotions valid at this property.

## Responses

- `200` - Promotions.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Kong Hotels Partner API
  version: 1.0.0
servers:
  - url: https://api.konghotels.cloud
    description: Kong Gateway
paths:
  /promotions:
    get:
      tags:
        - Promotions
      operationId: listPromotions
      summary: List public promotions
      description: Public promotions bookable today. Private codes (closed user
        groups) are not listed but can be looked up.
      parameters:
        - name: property
          in: query
          description: Only promotions valid at this property.
          schema:
            type: string
      responses:
        "200":
          description: Promotions.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: "#/components/schemas/Promotion"
security:
  - KongKeyAuth: []
  - KongConsumer: []
components:
  schemas:
    Promotion:
      type: object
      properties:
        code:
          type: string
          examples:
            - KONGWEEKEND
        name:
          type: string
        description:
          type: string
        discount:
          type: object
          properties:
            type:
              type: string
              enum:
                - percent
                - fixed_amount
            value:
              type: string
              examples:
                - "12.00"
            currency:
              type:
                - string
                - "null"
              description: Only for fixed_amount; the promotion applies only to properties in
                this currency.
        booking_window:
          type: object
          properties:
            from:
              type: string
              format: date
            until:
              type: string
              format: date
        stay_window:
          type: object
          properties:
            from:
              type:
                - string
                - "null"
              format: date
            until:
              type:
                - string
                - "null"
              format: date
        min_nights:
          type: integer
        property_codes:
          type:
            - array
            - "null"
          items:
            type: string
          description: null means all properties.
  securitySchemes:
    KongKeyAuth:
      type: apiKey
      in: header
      name: apikey
      description: Your API key, validated by Kong Gateway. The header name depends on
        the gateway's key-auth configuration.
    KongConsumer:
      type: apiKey
      in: header
      name: X-Consumer-ID
      description: "**Local development only.** Simulates the consumer identity Kong
        Gateway injects after authentication."
```