🧩API Documentation

Learn how to use our APIs, create credentials, authenticate requests, and build custom booking and guest workflows across bookings, guests, and availability.

Everything you need to connect external systems to Hostel Mate—create bookings, sync guests, fetch availability, and more.

Quick Start

1. Generate an API key: API Access

2. Exchange the key for a bearer token: Authentication

3. Call your first endpoint—for example Bookings Create

Core Guides

• Authentication: issue tokens and handle rate limits — read more

• Booking Engine API: surface availability on your website — read more

• Booking operations: Bookings Create and Bookings Update

• Guests endpoints: Guests GET and Guests Update

Best Practices

• Store API keys server-side only; rotate them after staff changes

• Use Idempotency-Key headers on write requests to prevent duplicates

• Respect the 120 req/min limit and add exponential backoff on 429 errors

• Log request IDs from responses to speed up support investigations

Need Help?

Send request IDs, timestamps, and payload summaries to [email protected] when opening a support ticket so we can assist quickly.