---
title: "Modify an order"
method: POST
path: "/orders/modify"
tags: ["Orders"]
---

# Modify an order

`POST /orders/modify`

Use this endpoint to modify certain aspects of an accommodation order, such as credit card details, checkin/checkout dates, and room configurations (guest allocation, guest names, and smoking preferences). 
  - See the [Orders modification guide](/demand/docs/orders-api/order-modify) for examples and best practices.

## Request body

- union
  - object
    - `order` string, required — Order ID to be modified
    - `modification` object, required
      - `accommodation` object, required
        - `reservation` integer, required — Reservation ID
        - `change` union, required
          - object
            - `checkin` string, date, required — New checkin date
            - `checkout` string, date, required — New checkout date
          - object
            - `room_reservation` integer — Room reservation ID
            - `allocation` object
              - …
            - `guests` object[] — Guest information for the room.
              - …
            - `smoking_preference` 'no_preference' | 'non_smoking' | 'smoking'
        - `type` 'dates' | 'room', required — Type of the accommodation change
  - object
    - `order` string, required — Order ID to be modified
    - `modification` object, required
      - `payment` object, required
        - `change` object, required
          - `cardholder` string, required — Cardholder name
          - `cvc` string, required — A 3 or 4 digit Card Verification Code (CVC) associated with the used card
          - `expiry_date` string, YYYY-MM, required — Card expiry date
          - `number` string, required — Card number
        - `type` 'card', required — Type of the payment change

## Response `200`

Successful modification

- union
  - object
    - `modification` object
      - `accommodation` object
        - `new_price` number, double — New price to be paid after the modification
        - `status` 'successful' | 'failed' — Status for this modification request.
  - object
    - `modifications` object
      - `payment` object
        - `status` 'successful' | 'failed' — Status for this modification request.

---

[API](https://skmtc.net/booking/apis/booking-com-demand-api.md) · [All operations](https://skmtc.net/booking/apis/booking-com-demand-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/booking-com-demand-api/revisions/e5f3dccae7ca/schema)