---
title: "Promotion"
url: "https://portal.konghotels.cloud/apis/kong-hotels-partner-api-1/versions/23cc133a-2f87-4d55-9490-0b8b2bb7dd78/schemas/Promotion"
---

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

# Promotion

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