Accounting Period Closure1

AdministrationAmenities2

Administrations2

AgeGroups2

AgendaPeriods8

AggregatedJournalTransactions1

Agreement PeriodicCosts2

Agreements5

Amenities3

AmenityGroups2

App Availabilities1

App Supported Payment Methods1

Availabilities1

Booking Customer1

Bookings5

Brands2

Categories7

Category Availability1

Category CategoryAmenities3

Category Costs1

Category Extras1

Category Images3

Category LOSPrices1

Category NightPrices1

Channel Bookings4

Channel Channels2

Channel Costs2

Channel ExtraPackages2

Channel Extras2

Channel PrimaryPackages2

Channel RentableTypes2

Channel Reservations7

Channel Security Deposit Policies2

Channels5

CheckoutPortal Bookings2

CheckoutPortal Reservations2

Contact Search1

Contacts3

Contractors2

Conversation messages4

Conversations2

Costs2

Costs Channels1

Costs RentableTypes2

CustomerLoginRequests1

Customers6

DAC7 Reports4

Debtors1

DiscountActions7

DiscountCampaigns2

DiscountCards2

Domains2

Executors2

ExtraPackages2

Extras2

Extras RentableTypes1

Facilities2

Guests2

InternalMessages1

InventoryObject Images3

InventoryObject MeterReadings2

InventoryObjects9

Invoice PeppolDeliveries3

Invoice Signatures1

Invoices3

JournalTransactions1

Labels4

LedgerAccount JournalTransactions1

LedgerAccounts2

MasterPriceList ComplexPrices1

MasterPriceList SimplePrices1

MasterPriceLists4

Measurers2

MeterTypes2

Night Registry1

Orders2

Organizations1

Owners4

Payment Batches3

PaymentHandlers5

PaymentMethods4

PaymentRequest Chargebacks1

PaymentRequests2

PaymentResults1

Payments3

PeriodicCosts2

Periods5

PrimaryPackage Categories1

PrimaryPackage RentableTypes1

PrimaryPackages2

Promotions2

Receipt Signatures1

Receipts2

RefundResults1

Registers3

RentableIdentities5

Rentables10

RentableSegments2

RentableType Availabilities1

RentableType Costs1

RentableType Extras1

RentableType Images3

RentableType LOSPrices1

RentableType NightPrices1

RentableType RentableTypeAmenities3

RentableType Security Deposit Policies1

RentableTypes5

Reservation ChangeRequests2

Reservation Extra Packages1

Reservation ExtraOrderItems2

Reservation Guests5

Reservation Memos1

Reservation Messages1

ReservationPreviews1

Reservations8

ReviewForm Reviews1

ReviewForms2

Reviews3

Security Deposit Policies RentableTypes1

SpecialPeriods2

Subdomains2

Subscriptions2

Supplier RentableTypes5

Supplier Reservations2

Supplier Suppliers4

Suppliers3

TaskCosts5

Todo Timesheets5

Todo TodoImages4

Todo UsedMaterials5

TodoLists5

Todos5

TrafficSources2

Users2

VATCodes2

Vouchers3

Channel Reservations

POST reservation

Changed on Nov 3, 2026

Create a new reservation

post/v3/channels/{channel_id}/reservations

Request

Base URL
https://api.bookingexperts.com
Auth
- API key in header X-API-KEY
- or OAuth 2
  Authorization code/oauth/authorize
  Token URL/oauth/token
TypeScript
https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/docs/v3/channels/:channel_id/reservations/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

channel_idstring required

Channel ID

Query parameters

fields[reservation]string

Fieldset. Specify a comma separated list of attributes to return

includestring

Includes list. Specify a comma separated list of resources to include.

confirmboolean

If set to true, makes the reservation confirmed. A confirmed reservation will not expire. Unconfirmed reservations will expire based on the temporary_booking_validity_in_hours attribute of the channel (by default 1 hour).

validate_minimum_advance_noticeboolean

If set to true, validates that the reservation preview satisfies the minimum advance notice requirements.

allow_reservations_in_the_pastboolean

If set to true, allows the reservation to start in the past.

validate_length_of_stay_does_not_exceed_max_av_cache_length_of_stayboolean

If set to true, validates that the stay of the reservation preview does not exceed the maximum length of stay supported by the availability cache (30).

Headers

Accept-Languagestring

Supported languages. A comma separated list with one or more of the following locales: cs, da-DK, de, de-AT, de-CH, en-US, en-GB, es, fr, fr-BE, fr-LU, it, nb, nl, nl-BE, pl, pt, tr, en, da. Default: 'en'.

Request body

Example request

{
  "data": {
    "type": "reservation",
    "attributes": {
      "payment_guarantee": "none",
      "price_according_to_channel_calculation": "total",
      "license_plates": [
        "75-DN-GP"
      ],
      "currency": "EUR"
    },
    "relationships": {
      "category": {
        "data": {
          "type": "category"
        }
      },
      "rentable_type": {
        "data": {
          "type": "rentable_type"
        }
      },
      "rentable_identity": {
        "data": {
          "type": "rentable_identity"
        }
      },
      "inventory_object": {
        "data": {
          "type": "inventory_object"
        }
      },
      "booking": {
        "data": {
          "type": "booking"
        }
      },
      "order": {
        "data": {
          "type": "order"
        }
      },
      "discount_card": {
        "data": {
          "type": "discount_card"
        }
      },
      "primary_package": {
        "data": {
          "type": "primary_package"
        }
      },
      "extra_packages": {
        "data": [
          {
            "type": "extra_package"
          }
        ]
      },
      "extra_order_items": {
        "data": [
          {
            "type": "extra_order_item"
          }
        ]
      },
      "cancellation_rules": {
        "data": [
          {
            "type": "cancellation_rule"
          }
        ]
      },
      "reservation_amenities": {
        "data": [
          {
            "type": "reservation_amenity"
          }
        ]
      },
      "available_optional_amenities": {
        "data": [
          {
            "type": "amenity"
          }
        ]
      },
      "labels": {
        "data": [
          {
            "type": "label"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "1",
      "type": "category",
      "attributes": {
        "country_code": "NL"
      },
      "relationships": {
        "city": {
          "data": {
            "type": "city"
          }
        },
        "terms": {
          "data": {
            "type": "terms"
          }
        },
        "rentable_segment": {
          "data": {
            "type": "rentable_segment"
          }
        },
        "master_price_list": {
          "data": {
            "type": "master_price_list"
          }
        },
        "guest_group_limits": {
          "data": [
            {
              "type": "guest_group_limit"
            }
          ]
        },
        "administration": {
          "data": {
            "type": "administration"
          }
        },
        "rent_earned_ledger_account": {
          "data": {
            "type": "ledger_account"
          }
        },
        "checkin_timetable": {
          "data": {
            "type": "timetable"
          }
        },
        "checkout_timetable": {
          "data": {
            "type": "timetable"
          }
        },
        "images": {
          "data": [
            {
              "type": "image"
            }
          ]
        },
        "rooms": {
          "data": [
            {
              "type": "room"
            }
          ]
        },
        "rentable_type_amenities": {
          "data": [
            {
              "type": "rentable_type_amenity"
            }
          ]
        },
        "optional_amenities": {
          "data": [
            {
              "type": "amenity"
            }
          ]
        },
        "attachments": {
          "data": [
            {
              "type": "attachment"
            }
          ]
        },
        "accommodation_type": {
          "data": {
            "type": "accommodation_type"
          }
        },
        "category_amenities": {
          "data": [
            {
              "type": "category_amenity"
            }
          ]
        }
      }
    }
  ]
}

Response

ReservationResponse

Example response

{
  "data": {
    "id": "1",
    "type": "reservation",
    "attributes": {
      "payment_guarantee": "none",
      "price_according_to_channel_calculation": "total",
      "license_plates": [
        "75-DN-GP"
      ],
      "currency": "EUR",
      "checkin_time": "14:00",
      "checkout_time": "10:00",
      "access_code": "1337",
      "stay_reason": "tourism, business"
    },
    "relationships": {
      "category": {
        "data": {
          "type": "category"
        }
      },
      "rentable_type": {
        "data": {
          "type": "rentable_type"
        }
      },
      "rentable_identity": {
        "data": {
          "type": "rentable_identity"
        }
      },
      "inventory_object": {
        "data": {
          "type": "inventory_object"
        }
      },
      "booking": {
        "data": {
          "type": "booking"
        }
      },
      "order": {
        "data": {
          "type": "order"
        }
      },
      "discount_card": {
        "data": {
          "type": "discount_card"
        }
      },
      "primary_package": {
        "data": {
          "type": "primary_package"
        }
      },
      "extra_packages": {
        "data": [
          {
            "type": "extra_package"
          }
        ]
      },
      "extra_order_items": {
        "data": [
          {
            "type": "extra_order_item"
          }
        ]
      },
      "cancellation_rules": {
        "data": [
          {
            "type": "cancellation_rule"
          }
        ]
      },
      "reservation_amenities": {
        "data": [
          {
            "type": "reservation_amenity"
          }
        ]
      },
      "available_optional_amenities": {
        "data": [
          {
            "type": "amenity"
          }
        ]
      },
      "labels": {
        "data": [
          {
            "type": "label"
          }
        ]
      },
      "administration": {
        "data": {
          "type": "administration"
        }
      },
      "discount_action": {
        "data": {
          "type": "discount_action"
        }
      },
      "order_items": {
        "data": [
          {
            "type": "order_item"
          }
        ]
      },
      "main_order_items": {
        "data": [
          {
            "type": "main_order_item"
          }
        ]
      },
      "available_discount_cards": {
        "data": [
          {
            "type": "discount_card"
          }
        ]
      },
      "available_primary_packages": {
        "data": [
          {
            "type": "primary_package"
          }
        ]
      },
      "available_extra_packages": {
        "data": [
          {
            "type": "extra_package"
          }
        ]
      },
      "available_extras": {
        "data": [
          {
            "type": "extra"
          }
        ]
      },
      "question_answers": {
        "data": [
          {
            "type": "question_answer"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "1",
      "type": "category",
      "attributes": {
        "country_code": "NL"
      },
      "relationships": {
        "city": {
          "data": {
            "type": "city"
          }
        },
        "terms": {
          "data": {
            "type": "terms"
          }
        },
        "rentable_segment": {
          "data": {
            "type": "rentable_segment"
          }
        },
        "master_price_list": {
          "data": {
            "type": "master_price_list"
          }
        },
        "guest_group_limits": {
          "data": [
            {
              "type": "guest_group_limit"
            }
          ]
        },
        "administration": {
          "data": {
            "type": "administration"
          }
        },
        "rent_earned_ledger_account": {
          "data": {
            "type": "ledger_account"
          }
        },
        "checkin_timetable": {
          "data": {
            "type": "timetable"
          }
        },
        "checkout_timetable": {
          "data": {
            "type": "timetable"
          }
        },
        "images": {
          "data": [
            {
              "type": "image"
            }
          ]
        },
        "rooms": {
          "data": [
            {
              "type": "room"
            }
          ]
        },
        "rentable_type_amenities": {
          "data": [
            {
              "type": "rentable_type_amenity"
            }
          ]
        },
        "optional_amenities": {
          "data": [
            {
              "type": "amenity"
            }
          ]
        },
        "attachments": {
          "data": [
            {
              "type": "attachment"
            }
          ]
        },
        "accommodation_type": {
          "data": {
            "type": "accommodation_type"
          }
        },
        "category_amenities": {
          "data": [
            {
              "type": "category_amenity"
            }
          ]
        }
      }
    }
  ]
}

Changes

Nov 3, 2026ff81bc4fefa9 Revision changes
- warning
  added the new da-DK enum value to the // response property for the response status
- warning
  added the new da-DK enum value to the /////// response property for the response status
- warning
  added the new da-DK enum value to the /////// response property for the response status
- warning
  added the new en-GB enum value to the // response property for the response status
- warning
  added the new en-GB enum value to the /////// response property for the response status
- warning
  added the new en-GB enum value to the /////// response property for the response status
- warning
  added the new en-US enum value to the // response property for the response status
- warning
  added the new en-US enum value to the /////// response property for the response status
- warning
  added the new en-US enum value to the /////// response property for the response status
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ///////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ///////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  the request optional property /////// became read-only
- info
  the request optional property /////// became read-only
- info
  the request optional property /////// became read-only
- info
  the request optional property /////// became read-only
- info
  the request optional property /////// became read-only
- info
  the request optional property /////// became read-only
- info
  added the new da-DK enum value to the request property //
- info
  added the new da-DK enum value to the request property ///////
- info
  added the new da-DK enum value to the request property ///////
- info
  added the new en-GB enum value to the request property //
- info
  added the new en-GB enum value to the request property ///////
- info
  added the new en-GB enum value to the request property ///////
- info
  added the new en-US enum value to the request property //
- info
  added the new en-US enum value to the request property ///////
- info
  added the new en-US enum value to the request property ///////
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  the response optional property /////// became read-only for the status
- info
  the response optional property /////// became read-only for the status
- info
  the response optional property /////// became read-only for the status
- info
  the response optional property /////// became read-only for the status
- info
  the response optional property /////// became read-only for the status
- info
  the response optional property /////// became read-only for the status
- info
  response property included/items/anyOf[DiscountAction]/relationships/discount_campaign deprecated
- info
  response property included/items/anyOf[DiscountAction]/relationships/discount_campaign/data deprecated
- info
  response property included/items/anyOf[DiscountAction]/relationships/discount_campaign/data/id deprecated
- info
  response property included/items/anyOf[DiscountAction]/relationships/discount_campaign/data/meta deprecated
- info
  response property included/items/anyOf[DiscountAction]/relationships/discount_campaign/data/meta/method deprecated
- info
  response property included/items/anyOf[DiscountAction]/relationships/discount_campaign/data/meta/temp_id deprecated
- info
  response property included/items/anyOf[DiscountAction]/relationships/discount_campaign/data/type deprecated

Operation history