# Bókun developer documentation

_This file helps AI assistants and crawlers discover the contents of this help center. Each article is also available as plain markdown by appending `.md` to its URL._

## Documentation

### [Getting started](https://bokun.helpkit.so/getting-started/rdxN2oggx1PcdUZtW5gGJ4)

- [Introduction](https://bokun.helpkit.so/getting-started/rdxN2oggx1PcdUZtW5gGJ4/introduction/uFNGUWatMLfUGuiLoAU7ez.md)
- [Building apps](https://bokun.helpkit.so/getting-started/rdxN2oggx1PcdUZtW5gGJ4/building-apps/5SNJmrbz5ivpw4HrELN4Ki.md)
- [Requirements for Public Apps on Bókun App Store](https://bokun.helpkit.so/getting-started/rdxN2oggx1PcdUZtW5gGJ4/requirements-for-public-apps-on-bókun-app-store/ozRD4BMqLLi7uGnycEDF45.md)
- [Example app](https://bokun.helpkit.so/getting-started/rdxN2oggx1PcdUZtW5gGJ4/example-app/oupHbLyrHszzZrDKD1nzjt.md)

### [API](https://bokun.helpkit.so/api/uzi4nXgs2wN1DhxkkLHves)

- [Access scopes](https://bokun.helpkit.so/api/uzi4nXgs2wN1DhxkkLHves/access-scopes/nQZQgB7dthWzPeQ5hNzxvC.md)
- [Authenticate with OAuth](https://bokun.helpkit.so/api/uzi4nXgs2wN1DhxkkLHves/authenticate-with-oauth/jfrEPmAX72TCXxgTZTWiG3.md)
- [GraphQL Reference](https://bokun.helpkit.so/api/uzi4nXgs2wN1DhxkkLHves/graphql-reference/vR2B5njQj3zPmZkSsHU8D8.md)
- [REST API](https://bokun.helpkit.so/api/uzi4nXgs2wN1DhxkkLHves/rest-api/6DoRE2fRjANWYBQdvTkFqU.md): General information about our REST API

### [Webhooks](https://bokun.helpkit.so/webhooks/g3YWZ24sADsceKK5vqrMzZ)

- [Creating an endpoint for webhooks](https://bokun.helpkit.so/webhooks/g3YWZ24sADsceKK5vqrMzZ/creating-an-endpoint-for-webhooks/fhyXqzU4KXuLWc7Dc8ioNU.md)
- [Webhook Events](https://bokun.helpkit.so/webhooks/g3YWZ24sADsceKK5vqrMzZ/webhook-events/migR39DGTnTr3qaRryEr7k.md)

### [Booking API (REST)](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i)

- [Configuring the platform for API usage and authentication](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/configuring-the-platform-for-api-usage-and-authentication/sFiGRpo4detkmrZPcWtQPj.md)
- [Introduction to the data model of  products](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/introduction-to-the-data-model-of-products/mGtiogVmyzywvDaZFK29b5.md)
- [Get product details](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/get-product-details/m48RCWuoQY6RsVA7w9QhDt.md)
- [Checking availability and pricing](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/checking-availability-and-pricing/9x4PcziToX5g8WG4j5KMxt.md)
- [Booking process](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/booking-process/7ce3yQRdURnCYQkhJsi2op.md)
- [Booking questions and answers](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/booking-questions-and-answers/r69Hx5qrLtMXpYzBCC6NPp.md)
- [Checkout](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/checkout/qfxwephtAWaRgPt22kpyLF.md)
- [Edit booking](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/edit-booking/buUq9hthirHPRE32154qLu.md)
- [Cancel booking](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/cancel-booking/xdTJgne6SUnMb7YnECZWUU.md)
- [Error codes](https://bokun.helpkit.so/booking-api-rest/vU6sCfxwYdJWd1QAcLt12i/error-codes/74JMBU2MhpKwrTRPZ2Lq3g.md)

### [RESTful API for creating, updating and accessing Experience products](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh)

- [Introduction and concepts](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/introduction-and-concepts/aSUKEVrdE1dmDpstNt1e94.md)
- [Component overview](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-overview/snDe1ZUChEodP6Y9q8AnYT.md)
- [Component: ACTIVATION](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-activation/xhuFWbVYeqRvAP5sigURWp.md)
- [Component: ALLOW_CUSTOMIZED_BOOKINGS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-allow_customized_bookings/aUtZxg7ijYji5Ub48dGCkT.md)
- [Component: ATTENTION](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-attention/iGiGvcrdWGFUpusJjmYeeJ.md)
- [Component: AVAILABILITY_RULES](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-availability_rules/cmcWqLSTLFpN1Tuvi6RCAF.md)
- [Component: BOOKING_LABELS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-booking_labels/iZ2i5hPj5yNL9JkidciGtG.md)
- [Component: BOOKING_QUESTIONS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-booking_questions/1ucHmTZWyJ5cUVy1jqaW9r.md)
- [Component: BOOKING_TYPE](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-booking_type/mmN5a93p7Hk3MqP4zSNLQm.md)
- [Component: BOX_SETTINGS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-box_settings/37rp8jup8betBnW6JNyYUB.md)
- [Component: CAPACITY_TYPE](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-capacity_type/bc8DWeA7gukjMsHxxqNi9W.md)
- [Component: CATEGORIES](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-categories/jRohSzZQWMq947jiT2spaU.md)
- [Component: COMBO](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-combo/9oxdnt3Msu7Q1kpqFPWm6T.md)
- [Component: COMMISSION_GROUP_ID](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-commission_group_id/rBTgbcyTLDtLjGYuYSsUBc.md)
- [Component: CREATED](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-created/gknt2ir9E1iLzg6ygpnRLN.md)
- [Component: CUSTOM_INPUT_FIELD_VALUES](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-custom_input_field_values/uEyfYPNEv2coGiZt2dUvdE.md)
- [Component: CUTOFF](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-cutoff/tu87Gee3FLrs6TDcaSW8dF.md)
- [Component: DEFAULT_OPENING_HOURS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-default_opening_hours/67MSWFzY6vJRzahcyr2aaP.md)
- [Component: DESCRIPTION](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-description/domr5ugQ1om4dswcADU17F.md)
- [Component: DIFFICULTY_LEVEL](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-difficulty_level/kp6PXECYA2SkZKRKh8HtNh.md)
- [Component: DURATION](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-duration/hbfmZqLuirvoGctPw1kDRu.md)
- [Component: EARLY_BOOKING_LIMIT](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-early_booking_limit/5tJUPwP2XncoeCs2GU9jDi.md)
- [Component: EXCLUDED](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-excluded/oEPPPBawj7xCEJvnf5CsDg.md)
- [Component: EXCLUSIONS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-exclusions/h6HkgUisS5w1SKAFBxq9jj.md)
- [Component: EXTERNAL_ID](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-external_id/3HQb6F4L7ShoHWSJgAQ1hF.md)
- [Component: EXTRAS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-extras/9BS9wEhnXFJVygRt1zXxGe.md)
- [Component: FLAGS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-flags/sGofH2fQmmDp2gEwidyzCE.md)
- [Component: GUIDANCE_TYPE](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-guidance_type/5ozqPu5CjVVM7Wujo4Hu96.md)
- [Component: ID](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-id/cFRn8q4rbNRUDSxwToeEZf.md)
- [Component: INCLUDED](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-included/vvBBSBipcUnMUD8NjdQEjh.md)
- [Component: INCLUSIONS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-inclusions/83xeHyp923ggdM1tn5Yd25.md)
- [Component: INVENTORY_SETTINGS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-inventory_settings/eVRKmNSDZDn4mwVHzSfQ4q.md)
- [Component: ITINERARY](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-itinerary/gUNjCXxADMv2xCPursHWHD.md)
- [Component: KEYWORDS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-keywords/uXfGsCwZJ3X6qwz5JZNiiT.md)
- [Component: KNOW_BEFORE_YOU_GO](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-know_before_you_go/rbqkUV1XrSN5gySaJ7fV7L.md)
- [Component: LAST_MODIFIED](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-last_modified/wutBJRZhwuuAsuqXGHjWMK.md)
- [Component: LOCATION](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-location/eXFJHWHY6RSLPmeqrJmwwB.md)
- [Component: MAIN_PAX_INFO](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-main_pax_info/gr84Tmyq3c9YmfJWhQj7DE.md)
- [Component: MEETING_TYPE_SETTINGS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-meeting_type_settings/xg9r4rj8Y5uszLPgvAuRYF.md)
- [Component: MIN_AGE](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-min_age/7iG7JKpJN7fBDHjXvjujwo.md)
- [Component: ON_REQUEST_DEADLINE](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-on_request_deadline/iZ7my1FJktdSUm1rXHm96K.md)
- [Component: OTHER_PAX_INFO](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-other_pax_info/itMxDZYBfHpxUS8u8agyya.md)
- [Component: PASS_SETTINGS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-pass_settings/cK1nTBziuTkaESQArJFy4A.md)
- [Component: PHOTOS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-photos/qPmFuzHzhDeNvYF7cLypEk.md)
- [Component: PRICING](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-pricing/5w7fdkvCMbcgkCL2U1UmDV.md)
- [Component: PRICING_CATEGORIES](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-pricing_categories/twxLEmmT9vr1cAWg2wRSb9.md)
- [Component: PRIVATE_EXPERIENCE](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-private_experience/7zc3xkZVXoqm59hfiT3gEv.md)
- [Component: RATES](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-rates/nM7ytZugtr68WsxXYfV5z7.md)
- [Component: REQUIREMENTS](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-requirements/9AuCoPGWTC3xEpiQRfsnbY.md)
- [Component:RESERVATION_TIMEOUT](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/componentreservation_timeout/rzEL2wxdgVxUJZqZ5jVycy.md)
- [Component: RETURN_PRODUCT_ID](https://bokun.helpkit.so/restful-api-for-creating-updating-and-accessing-experience-products/bhqyxa7kEuAYtM7J2go3Kh/component-return_product_id/3SFdNLR8G2fwokF8fAX974.md)

### [Channel Manager API](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd)

> Technical guide for implementing custom plugins for Bókun’s Channel manager

- [Overview](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/overview/ngZRtjHXMewiomPfARFDfZ.md)
- [Transport layer and general implementation guidelines](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/transport-layer-and-general-implementation-guidelines/s1bMqtkKHMcgYZHMTmdg7a.md)
- [Transport / gRPC](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/transport--grpc/oeNewvu1JuSPbj1wQTHsLW.md)
- [Transport / REST](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/transport--rest/nEFKnFCGJJPP1aF5Xoi9FP.md)
- [Channel manager plugin lifecycle](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/channel-manager-plugin-lifecycle/prvyCrvunbe9k8HCwK1avP.md)
- [Step 1: Plugin registration](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-1-plugin-registration/234RdvYJ3Q1zXidyTWDsUW.md)
- [Step 2: Retrieval of plugin definition](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-2-retrieval-of-plugin-definition/7xRgvC2FtZKmGUZNhRWdJf.md)
- [Step 3. Plugin configuration](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-3-plugin-configuration/s5m5KtqWjTmyJTMiMRpp3D.md)
- [Step 4: Product mapping](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-4-product-mapping/hX3WJg5cHqmUEtRMkrz139.md)
- [Step 5: Shallow & deep availability searches](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-5-shallow--deep-availability-searches/sPPmgCTjTdEPh1R1VfmhZp.md)
- [Step 6: Reservation and booking](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-6-reservation-and-booking/mskv6FZYULNxTHGwwxp4qs.md)
- [Step 7: Booking cancellation](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-7-booking-cancellation/g5ioid1MzT7wsfAjLsb579.md)
- [Step 8: Booking amendment](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/step-8-booking-amendment/qEGYUnkEHC1Xbbb8JwnygM.md)
- [Handling booking failures](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/handling-booking-failures/eukG3Qmm7xsphBx5yRrxWY.md)
- [Security](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/security/4nRbq1wvN7pSEuiANYoa2D.md)
- [Using the sample plugin](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/using-the-sample-plugin/xjWaU6NdqfwrZ6Lagu61Rz.md)
- [Running end-to-end tests](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/running-end-to-end-tests/i4agvN1qPS3bTTqJ2Rff7j.md)
- [Options for reselling products through Channel manager](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/options-for-reselling-products-through-channel-manager/hvjWt8eTzFjn6CFiq5Efg8.md)
- [FAQs](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/faqs/iXQFernUNA3b1NCXmkR9n2.md)
- [Appendix](https://bokun.helpkit.so/channel-manager-api/rGmzgGe66zjtEQ8FUvS8dd/appendix/thiHz7sves4PE1YpdFm22Z.md)

### [OCTO API](https://bokun.helpkit.so/octo-api/4k6pcPbAEZkaHwMbBN9m9C)

> Bókun’s implementation of the OCTO API Standard

- [Getting Started with the Bókun OCTO API](https://bokun.helpkit.so/octo-api/4k6pcPbAEZkaHwMbBN9m9C/getting-started-with-the-bókun-octo-api/4k6pcPbAEZ67nDa9QYpvSy.md): Getting Started Using The Octo API