> ## Documentation Index
> Fetch the complete documentation index at: https://docs.d-edge.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This site documents the D-EDGE APIs for technology partners (web agencies, OTAs, PMS and RMS vendors, booking and CRM tools). It is written for developers integrating with hotels that use the D-EDGE platform.
> Seven APIs, grouped by domain. Connectivity: Channel Manager API (distribute a hotel's inventory to your channel and send bookings back). Pricing & Availability: Best Price API (best offers to highlight), Quotation API (all bookable offers for a stay), Daily Rates API (daily availability between two dates). Booking: Booking Engine API (a hotel's full direct booking funnel), Gift Shop API (gift vouchers from catalogue to payment). Guest Management: CRM API (guest profiles).
> Pick the API by the need: to display prices, use the Best Price API or the Daily Rates API; to quote a specific stay, use the Quotation API; to book, use the Booking Engine API; to sell gift vouchers, use the Gift Shop API; to manage guest profiles, use the CRM API; to receive hotel inventory and send bookings back as a distribution channel, use the Channel Manager API.
> Base URLs, hotel identifiers, and credentials are delivered by the D-EDGE partnership team during onboarding. Do not invent base URLs, endpoints, parameters, or example credentials that do not appear on these pages.
> Authentication differs per API: OAuth 1.0 for Best Price, Quotation, Daily Rates, and Booking Engine; an X-API-KEY header for Gift Shop; OAuth 2.0 client credentials for CRM; partner-defined credentials carried in the XML message for the Channel Manager API. Read each API's Authentication page before writing code.
> A mock environment returns realistic but fictitious data without credentials. The Postman and Insomnia collections on the API collections page target it by default. Use it for exploration and tests, never for production traffic.
> Use the official names exactly: D-EDGE, D-EDGE platform, Channel Manager API, partnership team. Do not use Back Office or Extranet.
> Each API has a Changelog page. Check it for the current behaviour before relying on an older answer. For questions these pages do not answer, direct the reader to the Contact us page.

# Update the search filters for hotels

> Update the search filters for hotels



## OpenAPI

````yaml booking-engine-api/open-api/booking-engine-api.json PATCH /v2/{sessionId}/session/filters/hotels
openapi: 3.0.1
info:
  title: Booking Engine API
  version: v2
servers:
  - url: https://{apiBaseUrl}
    variables:
      apiBaseUrl:
        default: api.example.com
        description: Base URL delivered by D-EDGE during partnership setup
security: []
tags:
  - name: Basket
  - name: Booking
  - name: Configuration
  - name: Description
  - name: Loyalty
  - name: Promotion
  - name: Resources
  - name: Search
  - name: Session
paths:
  /v2/{sessionId}/session/filters/hotels:
    patch:
      tags:
        - Session
      summary: Update the search filters for hotels.
      description: "Available filters and filters values are returned by each search results.\r\n            \r\nThe sent filters replace existing filters in the session.\r\nIf a filter is sent with no values, it is deleted from the session.\r\n            \r\nSince these filters are contextual, they should be reset when Context is modified."
      operationId: Session_UpdateHotelFilters
      parameters:
        - name: X-AVP-Impersonation
          in: header
          description: ''
          required: false
          schema:
            type: string
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Session.UpdateSessionHotelFiltersRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/Session.UpdateSessionHotelFiltersRequest'
        description: The filters to set in the session.
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
            text/json:
              schema:
                type: object
        '204':
          description: The session filters are updated correctly
        '400':
          description: >-
            Some parameters are invalid or missing, check the error code value
            for more details
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/BookingEngine.Hub.Service.Examples.Session.InvalidSessionErrorResponse
              examples:
                response:
                  value:
                    code: InvalidSessionId
            text/json:
              schema:
                $ref: >-
                  #/components/schemas/BookingEngine.Hub.Service.Examples.Session.InvalidSessionErrorResponse
              examples:
                response:
                  value:
                    code: InvalidSessionId
        '401':
          description: >-
            Authentication header is invalid or does not give access to the
            operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/BookingEngine.Hub.Service.Controllers.ErrorResponse_BookingEngine.Hub.Service.Config.SecurityErrorType_
            text/json:
              schema:
                $ref: >-
                  #/components/schemas/BookingEngine.Hub.Service.Controllers.ErrorResponse_BookingEngine.Hub.Service.Config.SecurityErrorType_
components:
  schemas:
    Session.UpdateSessionHotelFiltersRequest:
      required:
        - filters
      type: object
      properties:
        filters:
          default: []
          type: array
          items:
            $ref: >-
              #/components/schemas/Session.HubSessionFilter_Search.HubSearchHotelFilterType_
      example:
        filters:
          - type: Localisation
            values:
              - <latitude>
              - <longitude>
              - '[range in meters]'
          - type: Budget
            values:
              - <price min>
              - '[price max]'
          - type: Rating
            values:
              - NoStar
              - OneStar
              - TwoStars
              - ThreeStars
              - FourStars
              - FiveStars
          - type: Amenities
            values:
              - MoneyExchange
              - ReceptionAvailable24Hours
              - LocalTaxNotIncluded
              - PetsWelcome
              - WheelchairAccess
              - MembershipCardRequired
              - MembershipCardSoldOnSite
              - Garden
              - Terrace
              - Elevator
              - CentralHeating
              - LinenIncluded
              - LinenAvailable
              - TowelIncluded
              - TowelAvailable
              - Laundry
              - BreakfastFacilities
              - MealFacilities
              - TakeAway
              - Cafeteria
              - Restaurant
              - NoAlcoholBar
              - BarbecueAvailable
              - Bar
              - FoodStore
              - AirConditioning
              - HotShower
              - BilliardRoom
              - TelevisionRoom
              - GamesRoom
              - Playground
              - ReadingRoom
              - BooksAvailable
              - NightClub
              - Excursions
              - Tennis
              - IndoorSwimmingPool
              - OutdoorSwimmingPool
              - Sauna
              - Jacuzzi
              - FitnessRoom
              - PosteRestante
              - MessageBoard
              - InternationalPhone
              - LocalPhone
              - Fax
              - InternetAccess
              - FreeInternetAccess
              - InternetCafe
              - LuggageRoom
              - SecureCarPark
              - TwoWheelerCarPark
              - CoachStationShuttle
              - TrainStationShuttle
              - AirportShuttle
              - BicycleRental
              - MotorbikeRental
              - CarRental
              - SafetyBox
          - type: City
            values:
              - Paris
          - type: Country
            values:
              - FR
    BookingEngine.Hub.Service.Examples.Session.InvalidSessionErrorResponse:
      required:
        - code
      type: object
      properties:
        code:
          default: InvalidSessionId
          type: string
        message:
          type: string
    BookingEngine.Hub.Service.Controllers.ErrorResponse_BookingEngine.Hub.Service.Config.SecurityErrorType_:
      allOf:
        - $ref: >-
            #/components/schemas/BookingEngine.Hub.Service.Controllers.ErrorResponse
        - required:
            - code
          type: object
          properties:
            code:
              $ref: >-
                #/components/schemas/BookingEngine.Hub.Service.Config.SecurityErrorType
    Session.HubSessionFilter_Search.HubSearchHotelFilterType_:
      allOf:
        - $ref: '#/components/schemas/Session.HubSessionFilter'
        - required:
            - type
          type: object
          properties:
            type:
              $ref: '#/components/schemas/Search.HubSearchHotelFilterType'
    BookingEngine.Hub.Service.Controllers.ErrorResponse:
      type: object
      properties:
        message:
          type: string
    BookingEngine.Hub.Service.Config.SecurityErrorType:
      description: >-
        Category of security failure returned when authentication or
        authorization is rejected.
      enum:
        - InvalidUserAuthentication
        - InvalidUserRoles
        - InvalidPermissions
      type: string
    Session.HubSessionFilter:
      type: object
      properties:
        values:
          description: The values defined for this category.
          type: array
          items:
            type: string
    Search.HubSearchHotelFilterType:
      description: Facet used to narrow down a hotel search result.
      enum:
        - Undefined
        - City
        - Country
        - Localisation
        - Rating
        - Budget
        - Amenities
      type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.