CASY API

Overview

Welcome to the CASY API documentation. This RESTful API provides access to hotel reservations, guest information, and property management data.

Authentication

All API requests require a valid bearer token. Include your token in the Authorization header:

Authorization: Bearer your-token-here

How to Get a Token

Token permissions are configured per client and may include:

• Hotel access (specific properties or all properties)
• Account data access (filtered by account ranges)
• Companion data access
• Admin permissions (token management, debug endpoints)

Rate Limiting

API requests are rate-limited to ensure service stability:

• Default Limit: 10 requests per 60 seconds
• Custom Limits: Available per token (configured on request)
• Rate Limit Response: HTTP 429 with details

{
  "error": "rate_limited",
  "window_seconds": 60,
  "limit": 10
}

Quick Start

1. Get Your Token

Contact support@casy.ch to request API access

2. Test Connection

Go to the Endpoints section to use the interactive Health Check Tester

3. Explore Endpoints

Head to the Endpoints section to see all available API routes and test your access

4. Understand Data Formats

Check Data Format for field types, date formats, and response structures

5. Handle Errors

Review Error Codes for troubleshooting guidance