🚀 Welcome

Turitop provides a powerful, standardized API for tours, activities, and attractions, built following the OCTO (Open Connectivity for Tours, Activities, and Attractions) standard.

With our API, you can:
✅ Retrieve real-time product availability
✅ Create, manage, and cancel bookings
✅ Fetch up-to-date supplier details
✅ Securely integrate with our scalable API

---

🌐 What is the OCTO Standard?

The OCTO standard is an open, community-driven API specification designed to simplify and standardize the way the travel industry exchanges data for tours, activities, and attractions.

By adopting OCTO, Turitop ensures:

• 🔄 Maximum compatibility with industry platforms
• 🚀 Faster and easier technical integrations
• ✅ Consistent, high-quality data exchange

---

🛠️ API Overview

Available Endpoints

Endpoint	Description
/products	Retrieve available products & details.
/availability	Check real-time availability for products.
/availability/calendar	Get calendar-based availability for products.
/bookings	Create, confirm, cancel, and retrieve bookings.
/supplier	Fetch supplier profile information.

---

🔑 Authentication

All API requests require an API Key for authentication.

🔐 How to Authenticate

Include your API Key in the request header:

Authorization: Bearer YOUR_API_KEY

---

📦 API Features

Feature	Description
🌍 Industry Standard	Built on the trusted OCTO open specification.
⚡ High Performance	Optimized for fast, large-scale integrations.
🔐 Secure	Uses API Key authentication for safe access.
🛠️ Flexible	Supports pagination and filtering for efficiency.

---

📄 Example API Requests

1️⃣ Get Available Products

curl -X GET "https://api.example.com/products"      -H "Authorization: Bearer YOUR_API_KEY"

📌 Response Example:

{
  "data": [
    {
      "id": "a4959959-51ac-5b79-afe0-2c8178e2fc00",
      "name": "Barcelona en un día: Sagrada Familia, Parque Güell y el casco antiguo",
      "locale": "en_US",
      "timeZone": "Atlantic/Canary +00:00"
    }
  ]
}

---

2️⃣ Check Availability

curl -X POST "https://api.example.com/availability"      -H "Authorization: Bearer YOUR_API_KEY"      -H "Content-Type: application/json"      -d '{
        "productId": "a4959959-51ac-5b79-afe0-2c8178e2fc00",
        "optionId": "default",
        "date": "2025-04-01",
        "units": [{"id": "470", "quantity": 2}]
     }'

📌 Response Example:

{
  "available": true,
  "capacity": 50
}

---

🤝 Get Started

Follow these steps to start using Turitop OCTO API:

1️⃣ Request API Credentials – Contact us at support@Turitop.com.
2️⃣ Read the API Docs – Review available endpoints & authentication.
3️⃣ Make Your First API Call – Try fetching available products.

📩 Need help? Our team is here for you! Contact us at support@Turitop.com.

---

🏢 About Turitop

Turitop specializes in connectivity solutions for tours, activities, and attractions. Our OCTO-powered API is built to provide seamless, reliable, and standardized integration for partners worldwide.

---