REST API

Booking API

A production-ready REST API for managing tours, pricing, availability, and bookings. Designed for travel and tour platforms with real-world booking rules.

View API Docs

Features

JWT authentication with role-based access (Admin / User)
Tour and pricing management (joiner & private)
Per-day capacity handling for joiner tours
Exclusive date blocking for private bookings
Availability endpoint for calendar UI integration
Docker-ready and production-safe

Core Concepts

Joiner bookings share daily capacity
Private bookings block dates exclusively
Availability is derived from bookings (no separate table)
Dates are handled in UTC for consistency

Key Endpoints

POST /api/auth/login
GET /api/tours
POST /api/bookings
GET /api/bookings/me
GET /api/tours/:id/availability

Status

API is running and ready to accept requests.

Health check: /health