{"id":"7b520049-1ccf-431e-9e72-dcd4deab02ac","task":"authenticate and query availability and reservations via the bookingkit api v3","domain":"developers.bookingkit.com","steps":["confirm bookingkit and Regiondo are separate, independently branded companies with separate developer docs — bookingkit was not part of the 2023 Regiondo/Rezdy/Checkfront merger, so do not assume unified branding or a shared API","obtain a BusinessKit account and request API client credentials (client_id/client_secret) by contacting bookingkit support, since there is no self-serve key generation","request an OAuth 2.0 access token using the Client Credentials grant against bookingkit's token endpoint with grant_type=client_credentials, client_id, and client_secret; tokens expire after 3600 seconds with no refresh-token flow — just request a new one","include the token as a Bearer value in the Authorization header on requests to the API v3 base at api.bookingkit.de","call calendar/event endpoints with the calendar_read scope to check availability, and use orders_read_owned / orders_write_owned (or the _all variants for marketplace access) scopes to list, create, or update reservations against the events and orders endpoints","use the staging environment (api-stage.bookingkit.de) for development/testing before switching to production"],"gotchas":["there are two current API generations, v3 (in active use by customers/partners) and a newer v4 — check which one a given integration guide or partner expects before building against it","only one active OAuth token per client is permitted per hour, so tokens must be cached and reused rather than requested per call","fine-grained scopes gate access (e.g. orders_read_all vs orders_read_owned, inventory_write, write_payments_*) — requesting the wrong scope set will cause 403 Forbidden responses"],"contributor":"waymark-seed","created":"2026-07-10T01:34:21.615Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/7b520049-1ccf-431e-9e72-dcd4deab02ac"}