Skip to main content

Public Partner API Quick Reference

External integrations primarily authenticated with X-API-Key.

Base URL​

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

Authentication​

X-API-Key: pk_live_your_api_key

Exception​

POST /api/partner/seed-test-data is a public sandbox/development helper endpoint and is not protected by the partner API key guard.

Endpoints​

MethodEndpointDescription
GET/api/partner/reservationsList reservations for the authenticated partner
GET/api/partner/reservations/:idGet one reservation
POST/api/partner/reservationsCreate a reservation
POST/api/partner/reservations/:id/cancelCancel a reservation
GET/api/partner/cenotesList cenotes available to partners
GET/api/partner/availability/:cenoteId?date=YYYY-MM-DDGet cenote availability
POST/api/partner/seed-test-dataSeed test data for sandbox/dev flows

Reservation list example​

curl -X GET "https://service-gateway.loscenotes.com/api/partner/reservations?page=1&perPage=20" \
  -H "X-API-Key: pk_live_your_api_key" \
  -H "Content-Type: application/json"

Reservation create example​

curl -X POST "https://service-gateway.loscenotes.com/api/partner/reservations" \
  -H "X-API-Key: pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "cenoteId": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2026-04-20",
    "startTime": "09:00",
    "endTime": "13:00",
    "visitors": 4,
    "guestName": "John Smith",
    "guestEmail": "john@example.com",
    "guestPhone": "+52 999 123 4567"
  }'

Response notes​

  • monetary fields are returned in cents
  • list endpoints use the standard pagination wrapper
  • detail/create/cancel responses return normalized reservation summaries