Added

  • Endpoint: GET special_periods
  • Endpoint: GET periodic_costs
  • Added the following relationships to schema Agreement:
    • rent_earned_account
    • owners_profile
  • Added the following relationships to schema RentableType Availability:
    • out_of_inventory
    • out_of_order
  • Added the following relationships to schema ReservationPreview:
    • available_optional_amenities
  • Added the following attributes to schema Admninistration:
    • ask_for_guest_phone
    • ask_for_fellow_guest_gender
    • ask_for_fellow_guest_address
    • ask_for_fellow_guest_postal_code
    • ask_for_fellow_guest_city
    • ask_for_fellow_guest_country,
    • ask_for_fellow_guest_email
    • ask_for_fellow_guest_phone
    • ask_for_fellow_guest_profession
  • Added the following relationships to schema Invoice :
    • owner

Changed

  • The attributes company and vat_nr of the Owner schema will always be returned, even if the Owner has not been marked as being a company.

We want to inform you that the API endpoint for Booking Experts is changing. If your system is currently making requests to api.bookingexperts.nl, please update your integration to use api.bookingexperts.com instead.

CDN Update

api.bookingexperts.com will use cdn.bookingexperts.com for static file delivery.
api.bookingexperts.nl will continue to use the old CDN cdn.bookingexperts.nl for the time being.

Important: Please note that this change may impact your Content Security Policy (CSP) headers.

We understand that this change will require adjustments on your part. However, we are confident that this transition will result in an improved experience with our API.

This change is necessary to ensure continued service and compatibility. Please make these adjustments by the 1st of July to prevent any disruptions. If you have any questions or need assistance with the transition, please do not hesitate to contact us. We are here to support you through this process. Thank you for your understanding and cooperation.

Action Required

  • Update all API requests to use api.bookingexperts.com
  • Ensure any hardcoded URLs or configurations reflect this change.
  • Please ensure that your CSP headers are adjusted to allow cdn.bookingexperts.com when migrating to api.bookingexperts.com.

Added

  • Endpoint: GET amenity_groups
  • Endpoint: GET amenity_group
  • Added the following relationships to schema RentableIdentity:
    • cluster_parent
  • Added the following relationships to schema PrimaryPackage and ExtraPackage:
    • book_period
    • stay_period
  • Added the following relationships to schema Invoice :
    • inventory_objects (only set for OwnerPeriodicInvoice)

Deprecated

  • RentableIdentity has been renamed to InventoryObject. The inventory_object:read scope has been added to all apps having rentable_identity:read in order to support migration.
  • Deprecated RentableIdentity endpoints are listed below.
    Please use the endpoints under InventoryObjects instead.
    • GET rentable_identities
    • GET rentable_identity
    • PATCH rentable_identity
    • DELETE rentable_identity
    • POST archive
  • Deprecated attributes are listed below.
    Please use the corresponding inventory_object relationship instead.
    • rentable_identity of schema Rentable
    • rentable_identity of schema Reservation
    • rentable_identity of schema Todo
    • rentable_identity of schema Contractor
    • rentable_identity of schema Review
    • active_rentable_identities of schema Owner
    • fixed_rentable_identity of schema CheckoutPortalReservation

Added

  • Added the following relationships to the schema of unaggregated JournalTransaction:
    • debit_vat_code: The vat code of the debit part of the transaction
    • credit_vat_code: The vat code of the credit part of the transaction
  • Endpoint: GET brands
  • Endpoint: GET brand
  • Endpoint: GET periodic_costs
  • Endpoint: GET periodic_cost
  • Endpoint: Costs: GET rentable_types
  • Endpoint: Extras: GET rentable_types
  • Added the following relationships to schema Subdomain:
    • brand
  • Added the following relationships to schema Reservation:
    • stay_reason
  • Added the following relationships to schema Cost:
    • amenities

Added

  • Added the following attributes to schema InteractiveMap:
    • source_url - Yields the link to the original image
  • Added the following attributes to schema ExtraPackage:
    • package_entries - yields the linked package entries
  • Added the following attributes to schema DiscountAction:
    • channels - yields the Channels to which the discount action applies
  • Added the following query params to endpoint GET master price lists:
    • active - When true, only master price lists in use will be returned
  • Added exempt to the list of possible values for attribute energy_label

Changed

  • POST discount_action
    • Support passing applicable channels and rentable_types

Added

  • Added the following attributes to schema Payment:
    • settled_with - yields the payment on the settled invoice or receipt (if any)
  • Added the following attributes to schema Administration:
    • default_option_validity - The default validity for options. Options are not allowed for guests when the value is 0.
    • max_options_per_customer - The maximum number of options allowed per customer.

Added

  • Added the following attributes to schema RentableType:
    • registration_number - Registration number for this type. It can be required by legislation to show this number when this type is advertised.
  • Added the following attributes to schema Reservation:
    • requires_pet_free - Can be used to explicitly require a pet free accommodation. The attribute cannot be true when the guest group contains pets. false means 'No preference'.
  • You can now include archived TodoLists:
    • GET /v3/administrations/:administration_id/todo_lists?include_archived=true
  • Added the following attribute to schema Invoice
    • type
  • Added the following attribute to schema RentableType
    • invoice_details
  • Added the following relationship to schema RefundRequest:
    • administration