# Key Collection API

Use this API to give your guests information about how can they reach property. You can set basic information about location and method itself, leave some comments and attach photos.

## Features

* Set up primary and alternative check-in methods for your property
* Upload photos and attach them to a check-in method
* [RESTful](https://en.wikipedia.org/wiki/Representational_state_transfer) API that speaks JSON


## Prerequisites

You must be [Content API](/connectivity/docs/content) certified to use Key Collection API. If you're a current Booking.com Connectivity Partner, your account manager can help you with certification. If you're new to Booking.com Connectivity, [submit your details](https://connect.booking.com) first.

Key Collection API uses the same [authentication methods](/connectivity/docs/authentication) as other APIs.

The Key Collection API is only applicable to [Booking Home property types](/connectivity/docs/codes-pct).

## Quickstart

1. Retrieve possible stream variations through the [stream-variations endpoint](/connectivity/docs/checkin-methods-api/generic-calls/#retrieve-stream-variations). At the moment we support these variations:
  * Primary (primary_checkin_method)
  * Secondary (alternative_checkin_method)
2. Retrieve check-in method names through [check-in-methods endpoint](/connectivity/docs/checkin-methods-api/generic-calls/#retrieve-check-in-methods).
3. Upload and manage photos (if necessary) using calls from [Manage photos](/connectivity/docs/checkin-methods-api/manage-photos) section, save the photo_ids that you want to use.
4. Set the check-in methods through the [set check-in method endpoint](/connectivity/docs/checkin-methods-api/per-property-calls#set-check-in-methods-for-property). All the data structures you need can be found at [Check-In Methods Descriptions](/connectivity/docs/checkin-methods-api/methods-descriptions). Do not forget to attach photos to your methods using [External references](/connectivity/docs/checkin-methods-api/external-references#external_references-structure).


## Swagger specifications

As an alternative of documentation that you see here you can also take a look at [Key Collection API swagger](https://supply-xml.booking.com/checkin-methods-api/swagger-ui#/).

## Going live

Before you go live with your API integration, you'll need to meet certain requirements. For more information, see [Going Live.](/connectivity/docs/going_live/)

## Support & feedback

Need help integrating with Check-In Methods API? The experts in our [Connectivity Support team](https://connectivity.booking.com/s/article/Contact-Us?language=en_US) are here to help.

Do you want us to improve this page?  Click `Yes` | `No` in the `Was this page helpful?` box at the bottom of this page.