API solution no longer usable
Retrieving and sending licence requirements for a property using the OTA_HotelDescriptiveInfo, OTA_HotelInvNotif or OTA_HotelDescriptiveContentNotif endpoint has been sunset since April 1, 2022 and is no longer usable. To retrieve current licence requirements and send your properties' licence information to Booking.com, use the new Licences API. To know more about all the features that were sunset, see the deprecation policy documentation.
This documentation section contains an API solution that is no longer usable. It will be removed on June 1, 2022. Until then, you can still access the topic by clicking the expand icon.
License requirements per region¶
Why your properties need license numbers¶
In certain countries or cities certain property types are required to display a license number in their online information. If you create properties in these regions using the Content API, you must provide a license number.
You can see the combinations of region and property type for which this is the case in the following table. Below that table, you can find important details about some table columns.
| Region | Property Class Type Code | Level | Regex pattern | Notes |
|---|---|---|---|---|
| Balaeric Islands | 25, 26, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 52, 7, 8 | property | ^[A-Za-z0-9]+$ |
- |
| Biarritz | 15, 22, 25, 26, 28, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 5007, 52, 7, 8 | room | ^.{13}$ |
Properties in this region must also specify the information included under LicenseInfos. |
| Bordeaux | 15, 22, 25, 28, 29, 3, 32, 34, 37, 46, 5, 5006, 5007, 52, 7, 8 | room | ^.{13}$ |
Properties in this region must also specify the information included under LicenseInfos. |
| Brazil | All property types | N/A | N/A | Instead of a property license, Brazilian properties need special invoicing details. |
| Cannes | 15, 22, 25, 26, 28, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 5007, 52, 7, 8 | room | ^.{13}$ |
- |
| Catalonia | 25, 26, 29, 3, 32, 34, 35, 37, 4, 46, 5, 5004, 5006, 52, 7, 8 | room | N/A | - |
| Denver | 16, 25, 26, 29, 3, 32, 34, 35, 37, 40, 46, 5, 5004, 5006, 5007, 52, 7, 8 | property | ^[0-9]{4}-BFN-[0-9]{6,}$ |
- |
| Hawaii | 15, 16, 18, 19, 20, 21, 22, 23, 27, 28, 30, 33, 36, 4, 40, 45, 50, 5000, 5001, 5002, 5003, 5005, 5007, 5008, 51, 6 | property | ^(?:W[0-9]{8}-[0-9]{2},?|TA-[0-9]{3}-[0-9]{3}-[0-9]{4}-[0-9]{2},?)+$ |
- |
| Hawaii | 25, 26, 29, 3, 31, 32, 34, 35, 37, 44, 46, 5004, 5006, 52, 7 | room | ^(?:W[0-9]{8}-[0-9]{2},?|TA-[0-9]{3}-[0-9]{3}-[0-9]{4}-[0-9]{2},?)+$ |
- |
| Iceland | 12, 14, 15, 21, 22, 25, 26, 28, 29, 3, 31, 32, 33, 34, 35, 37, 44, 46, 5, 50, 5000, 5001, 5002, 5003, 5004, 5005, 5006, 5007, 5008, 52, 6, 7, 8 | property | ^[A-Z]{2}-[0-9]{8}$ |
Some properties in this region may be exempt from providing a license number. |
| Japan | 15, 25, 26, 28, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 5007, 52, 7, 8 | property | ^[0-9A-Za-z]{10}$ |
Some properties in this region may be exempt from providing a license number. Properties in Japan may also require a license type and license issue date. See HotelDescriptiveContent. |
| Levallois-Perret | 15, 22, 25, 26, 28, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 5007, 52, 7, 8 | room | ^.{13}$ |
Properties in this region must also specify the information included under LicenseInfos. |
| Lyon | 15, 22, 25, 26, 28, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 5007, 52, 7, 8 | room | ^.{13}$ |
Properties in this region must also specify the information included under LicenseInfos. |
| Menton | 12, 14, 15, 22, 25, 26, 28, 29, 3, 31, 32, 34, 35, 37, 44, 46, 5, 5001, 5002, 5004, 5006, 5007, 52, 7, 8 | room | N/A | Properties in this region must also specify the information included under LicenseInfos. |
| Morocco | 16, 18, 20, 21, 23, 27, 30, 33, 36, 46, 40, 45, 50, 5000, 5001, 51 | property | ^[0-9]{5}[A-Z]{2}[0-9]{4}$ |
- |
| Nice | 15, 22, 25, 26, 28, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 5007, 52, 7, 8 | room | ^.{13}$ |
Properties in this region must also specify the information included under LicenseInfos. |
| Paris | 12, 14, 15, 21, 22, 25, 26, 28, 29, 3, 31, 32, 34, 35, 37, 44, 46, 5, 5001, 5002, 5004, 5006, 5007, 52, 7, 8 | room | ^[0-9]{13}$ |
Properties in this region must also specify the information included under LicenseInfos. |
| Portugal | All property types | property | N/A | - |
| San Francisco | 25, 29, 3, 32, 34, 35, 37, 46, 5, 5000, 5006, 52, 7, 8 | property | ^STR-[0-9]{7}$ |
Some properties in this region may be exempt from providing a license number. |
| Valencia | 25, 29, 3, 32, 34, 35, 37, 46, 5, 5006, 52, 7, 8 | N/A | N/A | This region has special requirements. Contact us for details. |
| Versailles | 15, 22, 25, 26, 28, 29, 3, 32, 34, 35, 37, 46, 5, 5004, 5006, 5007, 52, 7, 8 | room | ^.{13}$ |
Properties in this region must also specify the information included under LicenseInfos. |
Level¶
The Level column specifies whether you must provide the license number at property level (HotelDescriptiveContent[@PropertyLicenseNumber]) or room level (Room[@LicenseNumber]).
In some regions, like Hawaii, the level depends on the property type.
Regex pattern¶
The Regex pattern column shows the regular expression pattern we use to validate the license number. When the column says N/A, it means there is no fixed pattern, or we don't have the necessary information to provide one.
Exemption from license requirements¶
Properties in some regions may, under special circumstances, be exempt from providing a license number. It is the property owner's responsibility to know whether this is the case. Contact them if you need this information.
If a property is exempt from providing a license number, you should specify the following value in your request: HotelDescriptiveContent[@PropertyLicenseNumber="NoLicenseRequired"].