Version: 1.0.0
TVL (The Vacation Labs) Platform API
Comprehensive API for the TVL vacation rental platform. Supports multi-tenant property management, bookings, payments, channel distribution, and analytics.
Authentication
All endpoints require JWT authentication via the Authorization header:
Authorization: Bearer <jwt_token>
Rate Limiting
- 100 requests per minute per tenant (standard tier)
- 1000 requests per minute per tenant (premium tier)
- Rate limit headers included in all responses
Idempotency
All write operations (POST, PUT, PATCH, DELETE) support idempotency via the Idempotency-Key header.
Use a unique key (UUID recommended) to safely retry failed requests without duplicating operations.
Pagination
List endpoints use cursor-based pagination for performance and consistency:
cursor: Opaque cursor string for next pagelimit: Number of items per page (default: 20, max: 100)
Error Handling
All errors follow RFC 7807 Problem Details format with consistent structure and error codes.
Authentication
- HTTP: Bearer Auth
JWT token obtained from /auth/callback
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |
License
Proprietary