Integration types

Based on DMA Data Portability, Booking.com users have the option to port over relevant data from Booking.com to a third party online platform. After you register with Booking.com, you can use the Booking.com Data Portability API to seamlessly import a comprehensive copy of user data into your application(program or a piece of software), ensuring efficient data transfer and integration.

Overview

Data Porting for Booking.com Users

Booking.com users who are signed in can request to export relevant data in their accounts section on the Booking.com website. Once the request is made, they will receive a unique porting URL. By calling the URL you will be calling the Data Portability API which will allow your application to import the user's data.

Users can choose how long the data import is valid for:

• One-time use: The data import URL can be used only once to import data.
• Extended period: The data import URL remains valid for a longer period to import data.

Registration Process

To get access to the Data Portability API, you need to follow the registration process:

1. Fill out the registration form and follow the instructions sent in the confirmation email.
2. Respond in a timely manner to potential requests to receive additional information as part of the verification process.
3. Comply with the Integration requirements below.

Integration Requirements

To ensure your registration request with the Data Portability API service is accepted, you must configure the following integration types by following below guidelines:

1. Authentication: Your application must securely authenticate users to ensure that only authorized individuals can access the data.
2. Data Handling: Proper mechanisms must be in place to handle the imported data securely and in compliance with data protection regulations.
3. Error Management: You should provide clear feedback to users if something goes wrong during the data import process.

Failure to configure these integration types may result in your registration request with the Data Portability API service not being accepted.

Single Access

This scope allows for a one-time data import. After the data has been successfully imported, it cannot be accessed again using the same user provided URL.

1. Authenticate and obtain access token: Implement the authentication process as described in the Authentication Guide using the specified scope: ‘https://account.booking.com/scope/dma’. This will allow you to obtain an access token.
2. Get back the access token.
3. Call the Data Portability API: Call the user provided URL with the access token included in the request headers.
4. Receive Data: The user data will be returned as a zip folder containing the data based on the data schema.

Continuous Access

This scope allows for continuous data imports. Once a report has been successfully imported, it can be re-imported using the user-provided URL for the next 180 days. The user report is updated every 24 hours. If you import the data before 24 hours have passed, you will receive the last imported version of the data.

1. Authenticate and obtain access token: Implement the authentication process as described in the Authentication Guide using the specified scope: ‘https://account.booking.com/scope/dma_continuous’.
2. Obtain Refresh Token: After successful authentication, retrieve the refresh token. Ensure this token is stored securely for future use. Note: Always store both the refresh token and any sensitive data securely to ensure compliance with security and privacy best practices.
3. Request new access token: Whenever you need a new access token, use the stored refresh token to request one.
4. Get back a new access token.
5. Call the Data Portability API: Use the new access token to call the user provided URL and import the user data.
6. Receive Data: The user data will be returned as a zip folder containing the data based on the data schema.