# Travelbase Documentation

## Docs

- [Introduction](https://docs.travelbase.ai/index.md): The Travelbase Tenant API enables secure, programmatic access to Travelbase’s travel infrastructure, supporting the complete booking lifecycle including offer discovery, order management, ticket issuance, wallet operations, and real-time event integrations.
- [API Keys](https://docs.travelbase.ai/tenant-api/api.key.md): Learn how to securely use API keys to authenticate requests to the Travelbase API.
- [v1.0.0](https://docs.travelbase.ai/tenant-api/changelogs/v1.0.0.md): The first stable release of the Travelbase Business API. A complete, production-ready platform for searching, booking, and managing flights.
- [Authentication](https://docs.travelbase.ai/tenant-api/concepts/authentication.md): How to authenticate your requests to the Travelbase API.
- [Currency](https://docs.travelbase.ai/tenant-api/concepts/currency.md): All monetary values in the Travelbase API are denominated in US Dollars (USD).
- [Data Consistency](https://docs.travelbase.ai/tenant-api/concepts/data-consistency.md): Understand how Travelbase handles consistency guarantees, what to expect after writes, and how to build reliable integrations around them.
- [Environments](https://docs.travelbase.ai/tenant-api/concepts/environments.md): Travelbase provides isolated environments for development and production operations.
- [Error Handling](https://docs.travelbase.ai/tenant-api/concepts/errors.md): Errors are returned using standard HTTP status codes and structured JSON responses to help you debug quickly.
- [Idempotency](https://docs.travelbase.ai/tenant-api/concepts/idempotency.md): Idempotency prevents duplicate resource creation caused by retries or network interruptions. Include an idempotency key when performing write operations (**POST** or **PUT**).
- [Multi-Tenancy](https://docs.travelbase.ai/tenant-api/concepts/multi-tenancy.md): Build platforms on top of Travelbase by creating and managing isolated tenants — each with their own data, API keys, and configuration — from a single owner account.
- [Pagination](https://docs.travelbase.ai/tenant-api/concepts/pagination.md): Efficiently traverse large collections of resources using Travelbase's cursor-based pagination system.
- [Rate Limits](https://docs.travelbase.ai/tenant-api/concepts/rate-limits.md): The API enforces rate limits to ensure system stability and fair usage across all tenants.
- [Request & Response](https://docs.travelbase.ai/tenant-api/concepts/request-response.md): Learn about the structure of API requests and responses, including how to format your requests and interpret the data returned by the Travelbase API.
- [Retries](https://docs.travelbase.ai/tenant-api/concepts/retries.md): Know which requests are safe to retry, how to back off correctly, and how to use idempotency keys to prevent duplicate side-effects.
- [API Versioning](https://docs.travelbase.ai/tenant-api/concepts/versioning.md): Understand how Travelbase versions its API, how to target a specific version, and how to migrate safely when breaking changes are introduced.
- [Webhooks](https://docs.travelbase.ai/tenant-api/concepts/webhook-delivery.md): Configure outbound webhooks to receive real-time event notifications.
- [FAQs](https://docs.travelbase.ai/tenant-api/faqs.md): Learn how the travel industry works and how to integrate with Travelbase effectively.
- [Book a Flight](https://docs.travelbase.ai/tenant-api/guides/book-flight.md): Create, ticket, and confirm flight orders safely using Travelbase's stateful booking pipeline.
- [Error Handling](https://docs.travelbase.ai/tenant-api/guides/error-handling.md): Every Travelbase API error follows a consistent, structured format — whether a flight booking fails at authentication, a passenger record fails validation, or a payment is declined at the final leg of checkout. No matter where in the journey something goes wrong, the shape of the response is always…
- [Handle Expiration](https://docs.travelbase.ai/tenant-api/guides/handle-expiration.md): Safely handle expiring flight offers in your integration to avoid failed bookings and poor user experience.
- [Idempotency & Retries](https://docs.travelbase.ai/tenant-api/guides/idempotency.md): Ensure safe retries and prevent duplicate operations in financial and critical workflows.
- [Search Flights](https://docs.travelbase.ai/tenant-api/guides/search-flights.md): Search for flights and receive live offers in a single synchronous response. Use the returned offer ID directly to create a booking.
- [Webhooks](https://docs.travelbase.ai/tenant-api/guides/webhooks.md): Webhooks are **HTTP callbacks** Travelbase server sends to a client-registered URL whenever a registered event occurs. Unlike polling — where the client repeatedly asks "did anything happen?" — Our webhook push the answer the moment it does. They are the **authoritative source of truth** for final e…
- [Locations](https://docs.travelbase.ai/tenant-api/locations.md): Search and retrieve airport suggestions for origin and destination inputs.
- [Offers](https://docs.travelbase.ai/tenant-api/offers.md): Search, retrieve, and manage flight offers.
- [Orders](https://docs.travelbase.ai/tenant-api/orders.md): Create, manage, and ticket flight orders.
- [Overview](https://docs.travelbase.ai/tenant-api/overview.md): Core integration concepts including environments, authentication, rate limits, idempotency, error handling, and operational best practices for secure and reliable Travelbase API integrations.
- [Tenant](https://docs.travelbase.ai/tenant-api/tenant.md): View and update tenant-level configuration for your Travelbase account.
- [Wallet](https://docs.travelbase.ai/tenant-api/wallet.md): Retrieve wallet balance and view immutable ledger entries.
- [Webhooks](https://docs.travelbase.ai/tenant-api/webhooks.md): Configure outbound webhooks to receive real-time event notifications.