Introduction

Welcome to Tourfold—a comprehensive tour management platform designed to help organizations create, manage, and deliver exceptional tour experiences.

What Is Tourfold?

At its core, Tourfold is designed to let you:

• Create and manage tours with multiple stops and routes
• Assign drivers and track their locations in real-time
• Handle bookings and manage customer experiences
• Monitor tour progress with live updates and analytics
• Scale operations across multiple locations and tour types

About This Documentation

In this documentation, you'll learn how to:

• Configure Tourfold for your organization (Tenant).
• Use Our REST API:
  • Authentication (API Keys, Bearer tokens)
  • Error Handling (REST: RFC 9457, GraphQL: errors array)
  • Pagination & Filtering (Spring Boot style)
  • Real-time Updates (SSE)
    • …and more.
• Understand Key Concepts:
  • Tenant
  • User

Quick Start

1. View Our OpenAPI Spec
   Head over to our OpenAPI reference or download the spec directly:
   OpenAPI YAML

2. Check the Basics

   • Basics Guide explains how to authenticate, retrieve user info, and create tours.

3. Explore Advanced Features

   • API Error Handling for consistent error responses and debugging.
   • Nested Resources for managing tour stops and driver assignments.
   • Server-Sent Events for real-time tour updates.

Feedback & Contributions

We aim to keep this documentation clear and comprehensive. If you find anything confusing or missing:

• Open an Issue or Discussion in our repository.
• Contact Support at support@tourfold.com.
• Check System Status at status.tourfold.com.

Happy building with Tourfold!