Introduction
Welcome to the Travelese Engine API documentation
Travelese Engine API
The Travelese Engine API provides a unified interface to search, book, and manage flights across multiple providers. Our API normalizes data from different sources into a consistent format, making it easy to integrate with various flight providers through a single API.
Base URL
Travelese Engine API is built on REST principles and is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.
The Base URL for all API endpoints is:
Authentication
All API endpoints require authentication using a Bearer token. Include your API key in the Authorization header of each request:
To obtain an API key, please contact our support team.
Rate Limiting
The API implements rate limiting to ensure fair usage:
- 100 requests per minute per API key
- 1000 requests per hour per API key
When you exceed these limits, you’ll receive a 429 Too Many Requests
response.
Supported Providers
The Engine API currently integrates with the following providers:
- Amadeus: Access to traditional GDS inventory and full-service carriers
- Duffel: Direct connections to airlines through NDC, offering rich content and direct distribution
Response Format
All responses follow a standardized JSON format:
In case of errors:
Common Error Codes
INVALID_CREDENTIALS
: Invalid or missing API keyRATE_LIMIT_EXCEEDED
: Rate limit exceededINVALID_REQUEST
: Invalid request parametersPROVIDER_ERROR
: Error from underlying providerINTERNAL_ERROR
: Internal server error
Best Practices
- Implement Retry Logic: For temporary failures, implement exponential backoff
- Cache Responses: Cache search results according to our caching guidelines
- Handle Rate Limits: Monitor rate limit headers and adjust request rates
- Validate Input: Ensure all required parameters are provided and properly formatted
- Error Handling: Implement proper error handling for all possible response codes
Versioning
The API uses semantic versioning. The current version is accessible at:
Breaking changes will be introduced in new major versions, with appropriate migration periods.
Support
For technical support or questions about the API:
- Email: [email protected]
- Documentation Issues: GitHub Repository
- Status Page: status.travelese.ai
SDKs and Libraries
Official SDKs are available for:
- JavaScript/TypeScript: @travelese/engine-sdk
- Python: travelese-engine
Changelog
Keep track of API changes and updates in our changelog.
Travelese Engine is currently in beta. If you have any questions or feedback, please reach out to us at [email protected]
Was this page helpful?