API Documentation

A RESTful API for managing tours, events, guests, vehicles, expenses, billing, and notifications. Authenticate with an API key or a session and you're ready to integrate.

Base URL

Production:  https://yourdomain.com/api
Development: http://localhost:3000/api

Override locally with the NEXT_PUBLIC_API_BASE_URL environment variable.

Quick start

1. Authenticate — generate an API key from the dashboard.
2. Make your first request — e.g. list events.
3. Handle responses — read the errors and pagination contracts.

GET /api/events?page=1&limit=10 HTTP/1.1
Authorization: Bearer tke_live_aB3dE5gH7jK9mN1pQ3rS5tU7vW9xY1zA
Accept: application/json

Conventions

Every endpoint shares the same contracts for:

• Errors — envelope shape, status codes, recovery.
• Pagination — page + limit + envelope.
• Rate limits — quotas and backoff headers.
• Idempotency — what's safe to retry.
• Request IDs — correlation for support.
• Versioning — what counts as breaking.
• Webhooks — verifying inbound deliveries.

Resources