View source for OTAs: How to connect to Beds24 using API V2

[[Category:API_V2]]
[[Category:API V2 Integration Guides]]

<div class="heading">OTAs: How to connect to Beds24 using API V2</div>

 This page explains how OTAs can develop API connectivity with Beds24

==Use case==
You are an OTA, Booking Engine, or similar, and want to retrieve property, price and availability information from Beds24 to generate bookings which you then send back to Beds24.

Your developer develops the integration between your system and Beds24.

==The Basics==
It is a good idea to get a basic understanding of how Beds24 works.

We recommend going through [https://wiki.beds24.com/index.php/Introduction this introduction] and creating a test property with prices and any data you intend to use.

==The API==
Beds24 has two API versions, V1 and V2, we recommend using V2 for any new projects.

Documentation for API V2 is [https://wiki.beds24.com/index.php/Category:API_V2 available here.]

There is also interactive [https://beds24.com/api/v2/#/ Swagger documentation.] We recommend using Swagger to try the examples in this guide.

Beds24 API's have strict usage limits and you need to design your interface to stay within these limits. This may mean caching data which is not expected to change often at your side rather than making a call each time you need it and only making calls when necessary. The Beds24 API is not intended or suitable for applications making significant numbers of real time calls, for example in response to public user actions. Data required in real time for your public pages should be cached at your end.

==API V2 Authentication==
API V2 uses refresh tokens which generate access tokens, these tokens will be included as headers in your requests in this format: "token: {token}"

To obtain a refresh token, first go the [https://beds24.com/control3.php?pagetype=apiv2 API page] in the control panel and click the generate invite code button. Select the scopes you require then click the generate invite code button. You will now see an invite code on this page, you can copy this to your clipboard and use the [https://api.beds24.com/v2/#/Authentication/get_authentication_setup GET /authentication/setup] endpoint to exchange your invite code for a refresh token.

Request:
<pre>curl -X 'GET' \ 'https://beds24.com/api/v2/authentication/setup' \ -H 'accept: application/json' \ -H 'code: abc123'</pre>
Response:
<pre>
{
  "token": "qEK5L...",
  "expiresIn": 86400,
  "refreshToken": "iexTC..."
}
</pre>
In the above example, "token" is a short term access token that you will use to authenticate other API calls, "expiresIn" is how many seconds the token will last, finally you can use "refreshToken" to generate more tokens in the future.

 Try making an invite code and exchanging it for a refresh token yourself with our [https://beds24.com/api/v2/#/Authentication/get_authentication_setup Swagger page]

==Retrieving property data from Beds24==
You can get properties from Beds24 using the [https://beds24.com/api/v2/#/Properties/get_properties GET /properties] endpoint. This should be a once off operation to construct or map the property on your side.

Try GETing properties with this request
<pre>
curl -X 'GET' \ 'https://beds24.com/api/v2/properties' \ -H 'accept: application/json' \ -H 'token: 123...'
</pre>
If successful, you should be able to see information about your properties in the JSON response.

 In Swagger, try clicking the "schema" under [https://beds24.com/api/v2/#/Properties/post_properties POST /properties] to see all the fields you can set using this endpoint.

By default not all property data will be returned, to include additional information in the response you can include parameters. For example, to include all of a property's room data in the response, add the parameter ?includeAllRooms=true to the request URL
<pre>
curl -X 'GET' \ 'https://beds24.com/api/v2/properties?includeAllRooms=true' \ -H 'accept: application/json' \ -H 'token: 123...'
</pre>

==Price and availability==
===Calendar===
[https://beds24.com/api/v2/#/Inventory/get_inventory_rooms_calendar GET /inventory/rooms/calendar] can be used to retrieve per day price and availability information. 
Use this to retrieve room availability and pricing detail in bulk, for example one year at a time and cache it on your side. Generally performing this call about once per 6 hours is enough to keep the data in sync.

===Availability===
[https://beds24.com/api/v2/#/Inventory/get_inventory_rooms_availability GET /inventory/rooms/availability] can be used to retrieve the availability status of dates.
Use this to retrieve room availability, this can be used after a guest has selected dates and started a booking to check the dates are still available.

===Offers===
[https://beds24.com/api/v2/#/Inventory/get_inventory_rooms_offers GET /inventory/rooms/offers] can be used to retrieve offers based on specified criteria.
Use this to check availability for a specific conditon when check-in and out dates and occupancy is known, for example in real time just before accepting a booking. This can be used to confirm all details and price for the booking are still current.

==Bookings==
[https://beds24.com/api/v2/#/Bookings/post_bookings POST /bookings] can be used to send bookings to Beds24. This will close availability for those dates at all other booking sources.

</div>