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

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

# ChangeEvent

## 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:
    EventType:
      type: string
      enum:
        - reservation.created
        - reservation.modified
        - reservation.cancelled
        - reservation.add_ons_changed
        - availability.changed
        - rates.changed
        - property.updated
        - promotion.published
        - review.published
        - group_request.created
        - group_request.updated
        - webhook.ping
    ChangeEvent:
      type: object
      properties:
        id:
          type: string
          examples:
            - evt_01jbx5a1b2c3d4e5f6g7h8j9k0
        sequence:
          type: integer
          description: Monotonic position in the feed; use as the `since` cursor.
        type:
          $ref: "#/components/schemas/EventType"
        occurred_at:
          type: string
          format: date-time
        property_code:
          type:
            - string
            - "null"
        subject:
          type: object
          properties:
            type:
              type: string
              examples:
                - reservation
                - room_type
                - property
                - review
                - group_request
            id:
              type: string
              examples:
                - KH7Q4M2X9
                - KTNYC:TWRK
        data:
          type: object
          additionalProperties: true
          description: >
            Payload by event type:


            | Type | `data` fields |

            |---|---|

            | `availability.changed` | `room_type_code`, `start_date`,
            `end_date` (inclusive stay nights). Refetch availability for that
            range. |

            | `rates.changed` | `room_type_code`, `start_date`, `end_date`,
            `rate_plan_codes`, `lowest_rate` (current lowest nightly base rate
            in the range), `currency` |

            | `property.updated` | `changed_sections` (any of `description`,
            `amenities`, `photos`, `policies`), `summary` |

            | `promotion.published` | `code`, `name`, `bookable_until`,
            `property_codes` (null = all) |

            | `review.published` | `review_id`, `overall_rating` |

            | `reservation.created` / `.modified` / `.cancelled` /
            `.add_ons_changed` | `confirmation_number`, `partner_reference`,
            `status`, `check_in`, `check_out`, `total`, `currency`, plus
            `changed_fields` (modified), `cancellation_fee` (cancelled) or
            `add_ons` (add-ons changed). Status changes made at the property,
            such as check-in and check-out, arrive as `reservation.modified`. |

            | `group_request.created` / `.updated` | `reference`, `status`,
            `rooms_requested` |

            | `webhook.ping` | `message` |
      examples:
        - id: evt_01jbx5a1b2c3d4e5f6g7h8j9k0
          sequence: 4182
          type: availability.changed
          occurred_at: 2026-10-24T05:54:42Z
          property_code: KTNYC
          subject:
            type: room_type
            id: KTNYC:TWRK
          data:
            room_type_code: TWRK
            start_date: 2026-12-04
            end_date: 2026-12-06
```