Hotel policies

Retrieve all descriptive information you need about a rate's policies for a given hotel.

Version
1.0.0
Status
Live
Incident
No incident

How to use it?

HTTP Methods

The API is accessible only through the Https protocol and only accepts HTTP POST requests.
It's made to retrieve information only – and not to modify it in any way.

UAT base URL: 
"https://rec-api.accor.com/catalog"
PRO base URL: 
"https://api.accor.com/catalog/"

UAT Example: "https://rec-api.accor.com/catalog/v1/hotels/3434/policies"

HTTP Response codes

We use conventional HTTP response codes to indicate the success or failure of an API request.

  • Codes in the 2xx range indicate success.
  • Codes in the 4xx range indicate an error.
  • Codes in the 5xx range indicate an server error.

Some 4xx errors that could be handled programmatically include an error code that briefly explains the error reported.

Squiggly Filter

Our API supports Squiggly, the Squiggly Filter is a Jackson JSON PropertyFilter, which selects properties of an object/list/map using a subset of the Facebook Graph API filtering syntax.

The easiest way to use this feature is to filter fields on the querystring like so:

  • ?fields=code,description

Doc: https://github.com/bohnman/squiggly

HTTP ACCEPT-LANGUAGE

Our API supports, with certain qualifications, the ability to specify languages as part of an HTTP request, using the ACCEPT-LANGUAGE HTTP header. The Hotel rates API honors this header where possible, selecting a language from the ACCEPT-LANGUAGE header and returning messages in that language.

When the ACCEPT-LANGUAGE header contains no language or a language that the API can't support, messages are returned in a default language, in this case it will be English.

Example

Using CATALOG Hotel Options

This service will provide you with the policies informations of a hotel .

{
  "policies": [
    {
      "code": "CDV1",
      "name": [
        {
          "label": "Policy Name EN",
          "language": "en"
        },
        {
          "label": "Policy Name FR",
          "language": "fr"
        }
      ],
      "description": [
        {
          "label": "Policy description EN",
          "language": "en"
        },
        {
          "label": "Policy description FR",
          "language": "fr"
        }
      ]
    }
  ]
}

Error example :

{
    "title": "HOTEL_NOT_FOUND",
    "status": "404",
    "detail": "The hotel does not exist",
    "requestId": "dc33f7a3-6958-4b8b-907b-843cf61072fb"
}

 

 

About us

We are far more than a worldwide leader. We are 300,000 hospitality experts placing people at the heart of what we do, and nurturing real passion for service and achievement beyond limits. We take care of millions of guests in our 5,000 addresses.