Welcome to LosCenotes Partner API

---

Welcome to the official documentation for the LosCenotes Partner API. This documentation will guide you through integrating your platform with LosCenotes to manage cenote and tour reservations in the Yucatan Peninsula.

---

🚀 Quick Start

Get started with our API in just a few minutes:

1. Get your API Keys - Request access from our partner team
2. Make your first call - Use the X-API-Key header for authentication
3. Go Live - Switch to production keys (pk_live_*) when ready

🏖️ What is LosCenotes?

LosCenotes is the leading platform for cenote and tour tourism in the Yucatan Peninsula. We connect:

• Travelers - looking for unique cenote experiences
• Cenote Owners - managing their properties
• Tour Operators - organizing group visits
• Technology Partners - enhancing the ecosystem

📚 Documentation Overview

Getting Started

Learn the basics and make your first API call

API Reference

Complete reference for all endpoints

Pricing & Age Groups

Price calculations and age category multipliers

Checkout & Payments

Payment processing with Stripe, PayPal, MercadoPago

🔑 API Keys

We use different API key prefixes for each environment:

Environment	Key Prefix	Description
Production	pk_live_	Live production data

🔐 Authentication

All API requests require the X-API-Key header:

curl -X GET "https://service-gateway.loscenotes.com/partner/cenotes" \
  -H "X-API-Key: pk_live_your_api_key" \
  -H "Content-Type: application/json"

💡 Key Features

• RESTful API - Standard HTTP methods and status codes
• JSON Responses - Consistent response format
• Multi-language - i18n support (es, en, fr)
• Age-based Pricing - 5 age categories with multipliers
• Multiple Payment Methods - Stripe, PayPal, MercadoPago, On-site

📊 Response Format

All API responses follow this structure:

{
  "success": true,
  "message": "operation.success",
  "data": { ... },
  "pagination": { ... },
  "currency": {
    "code": "MXN",
    "symbol": "$"
  }
}

🚦 Rate Limits

Plan	Requests/Hour
Basic	1,000
Pro	10,000
Enterprise	Custom

📞 Support

Need help? We're here for you:

• 📧 Email: partners@loscenotes.com
• 🌐 API Status: status.loscenotes.com

🎯 Next Steps

1. Authentication
2. Make your first call
3. Pricing & Age Groups
4. Checkout Flow

---

Last updated: December 2025