Getting Started

Learn how to integrate with the Jets & Partners Booking Engine API in minutes.

Prerequisites

Before you begin, you'll need:

  • An API key from Jets & Partners
  • Basic knowledge of REST APIs
  • An HTTP client (curl, Postman, or your programming language's HTTP library)

Request an API Key

To get started, contact our team to request API access:

Email: hello@jets.partners

Include your company name, intended use case, and expected request volume.

Base URL

All API requests should be made to:

https://booking.api.jets.partners/v1

Authentication

Include your API key in the Authorization header:

Authorization: Bearer jtp_your_api_key_here

Alternatively, you can use the X-API-Key header:

X-API-Key: jtp_your_api_key_here

Your First Request

Let's search for available flights:

curl -X POST https://booking.api.jets.partners/v1/flights/search \
  -H "Authorization: Bearer jtp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "legs": [
      {
        "origin": { "icao": "KJFK" },
        "destination": { "icao": "KLAX" },
        "departure": "2024-06-15T10:00:00Z",
        "passengers": 4
      }
    ],
    "category": "midsize_jet",
    "includePhotos": true,
    "checkAvailability": true
  }'

Response Format

All responses are returned in JSON format:

{
  "success": true,
  "data": {
    "options": [
      {
        "id": "opt_1",
        "aircraft": {
          "type": "Midsize Jet",
          "manufacturer": "Hawker",
          "model": "Hawker 900XP",
          "category": "midsize_jet",
          "capacity": 9
        },
        "price": {
          "amount": 12500.00,
          "currency": "USD"
        },
        "availability": true,
        "estimated_flight_time": "2h 15m"
      }
    ]
  }
}

Rate Limits

API rate limits are configured per API key:

Limit Type Default
Per Minute 60 requests
Per Hour 1,000 requests
Per Day 10,000 requests

Rate limit headers are included in all responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1640000000

Next Steps