Skip to main content

Quick Start Guide

Get up and running with the current LosCenotes partner surface.

Step 1: Use the correct base URL​

https://service-gateway.loscenotes.com/api

All current examples use the global /api prefix.

Step 2: Make your first partner request​

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

Step 3: Understand the response wrapper​

{
  "success": true,
  "message": "partners.cenotes.list_retrieved_successfully",
  "data": [],
  "pagination": {
    "total": 45,
    "perPage": 10,
    "currentPage": 1,
    "lastPage": 5
  },
  "meta": {
    "requestId": "req_123",
    "processingTime": 24,
    "version": "1.0.0",
    "cacheHit": false
  }
}

Step 4: Calculate pricing​

curl -X POST "https://service-gateway.loscenotes.com/api/pricing/calculate-complete" \
  -H "Content-Type: application/json" \
  -d '{
    "itemType": "cenote",
    "itemId": "550e8400-e29b-41d4-a716-446655440000",
    "ageBreakdown": {
      "adult": 2,
      "child": 1
    }
  }'

Step 5: Validate before booking​

curl -X POST "https://service-gateway.loscenotes.com/api/public/reservations/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "itemType": "cenote",
    "itemId": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2026-04-20",
    "startTime": "09:00",
    "visitors": 3
  }'

Important notes​

  • partner external integrations use X-API-Key
  • prices documented for partner/shared booking flows are generally expressed in cents, unless a page explicitly clarifies a different metadata case
  • for current surface details, prefer the API reference pages over older generic onboarding material