shield Security Guide

API Authentication

Biletchi uses OAuth2 and API keys to provide secure access to our travel data. Learn how to authenticate your requests and manage your integration credentials.

1 Generate API Key

To start using the Biletchi API, you must first generate an API key from the developer portal. This key should be included in every request via the header.

warning Keep your keys secret. Do not share them in client-side code.

2 Header Usage

Include your API key in the X-Biletchi-Key header for all authenticated requests.

Content-Type

application/json

content_copy

X-Biletchi-Key

your_api_key_here_••••••••

content_copy

3 Rate Limiting

Standard B2B accounts are limited to 1,000 requests per minute. Exceeding this will return a 429 Too Many Requests response.

View usage metrics open_in_new 
// Request
GET /v2/flights/search
Headers: {
  "X-Biletchi-Key": "sk_test_51Mz...",
  "Accept": "application/json"
}

// Response Body
{
  "status": "success",
  "data": {
    "results": [
      {
        "id": "FLT_7721",
        "airline": "Turkish Airlines",
        "departure": {
          "airport": "IST",
          "time": "2023-11-20T14:30:00Z"
        },
        "arrival": {
          "airport": "LHR",
          "time": "2023-11-20T16:45:00Z"
        },
        "price": {
          "amount": 284.50,
          "currency": "USD"
        }
      }
    ]
  }
}

Related Resources

settings_ethernet
Webhooks Reference

Subscribe to real-time events like ticket issuance and status changes.

arrow_forward
terminal
SDK Libraries

Official wrappers for Python, JavaScript, and Java to speed up your build.

arrow_forward
support_agent
Technical Support

Dedicated B2B support channel for complex integration assistance.

arrow_forward