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 reservations in the Yucatan Peninsula.

🚀 Quick Start

Get started with our API in just a few minutes:

1. Get your API Keys - Request sandbox access from our partner portal
2. Test in Sandbox - Use test API keys (sk_test_*) to develop
3. Go Live - Switch to production keys (pk_live_*) when ready

🏖️ What is LosCenotes?

LosCenotes is the leading platform for cenote 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

Real-time event notifications

Sandbox Testing

Safe testing environment

SDKs

Official SDKs for multiple languages

🔑 API Keys

We use different API key prefixes for each environment:

Environment	Key Prefix	Description
Sandbox	sk_test_	Testing with mock data
Production	pk_live_	Live production data

💡 Key Features

• RESTful API - Standard HTTP methods and status codes
• JSON Responses - Consistent response format
• Sandbox Mode - Full testing environment
• Rate Limiting - Fair usage policies
• Multi-language - i18n support

🛠️ Available SDKs

Official SDKs make integration easier:

• TypeScript/JavaScript
• PHP
• Python

📊 Response Format

All API responses follow this structure:

{
  "success": true,
  "message": "operation.success",
  "data": { ... },
  "pagination": { ... }, // For list endpoints
  "_sandbox": true // In sandbox mode
}

🚦 Rate Limits

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

📞 Support

Need help? We're here for you:

• 📧 Email: partners@loscenotes.com
• 🌐 API Status: status.loscenotes.com
• 🐛 GitHub Issues: github.com/loscenotes/partner-api

🎯 Next Steps

1. Create your first API key
2. Make your first API call
3. Test in sandbox

---

Last updated: January 2025