---
title: "Booking"
description: "Booking"
url: "https://portal.kongair.dev/guides/bookings"
image: "https://portal.kongair.dev/_og/d/c_Ocean.takumi,title_Booking,description_Booking,props_eyJ0aGVtZSI6eyJjb2xvcnMiOnsicHJpbWFyeSI6IiMyQUJEQkIifX19,p_Ii9ndWlkZXMvYm9va2luZ3Mi,s_yexDS6aPJj2CiVwV.png"
---

# KongAir Booking API

Obtain API keys

To obtain API keys for Booking API, qualification is required

[Contact Partner Relations](https://portal.kongair.dev/partner-services)

## [Introduction](#introduction)

Welcome to the **KongAir Booking API**. KongAir offers a seamless flight booking experience through its API, allowing users to search for available flights, create bookings, retrieve booking details, and cancel reservations. This API is ideal for travel agencies, booking platforms, and airline service providers.

## [APIs](#apis)

![Booking Async API](https://portal.kongair.dev/_core/api/v3/apis/booking-async-api/images/icon/raw)

## Booking Async API

1.0.0

Kafka-based event-driven architecture to create Bookings.

[View API](https://portal.kongair.dev/apis/booking-async-api/docs)

![Bookings API](https://portal.kongair.dev/_core/api/v3/apis/bookings-api/images/icon/raw)

## Bookings API

1.0.0

Lookup or create bookings

[View API](https://portal.kongair.dev/apis/bookings-api/docs)

## [Base URL](#base-url)

```text
https://api.kongair.com/v1
```

All endpoints should be prefixed with the above base URL.

## [Authentication](#authentication)

The API requires an API key for authentication. Include your API key in the `Authorization` header:

```text
Authorization: Bearer YOUR_API_KEY
```

## [Endpoints](#endpoints)

### [Retrieve Available Flights](#retrieve-available-flights)

#### [**GET /flights**](#get-flights)

Fetch a list of available flights based on search criteria.

#### [**Request Parameters**](#request-parameters)

| Parameter   | Type   | Location | Required | Description                        |
| :---------- | :----- | :------- | :------- | :--------------------------------- |
| origin      | string | Query    | Yes      | IATA code of the departure airport |
| destination | string | Query    | Yes      | IATA code of the arrival airport   |
| date        | string | Query    | Yes      | Flight departure date (YYYY-MM-DD) |

#### [**Response**](#response)

##### **Success (200 OK)**

```json
[
  {
    "id": "FL1234",
    "origin": "JFK",
    "destination": "LAX",
    "departure_time": "2025-06-01T08:30:00Z",
    "arrival_time": "2025-06-01T11:30:00Z",
    "price": 350.75
  }
]
```

---

### [Create a New Booking](#create-a-new-booking)

#### [**POST /bookings**](#post-bookings)

Reserve seats on a selected flight.

#### [**Request Body**](#request-body)

```json
{
  "flight_id": "FL1234",
  "passengers": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birth": "1985-05-20",
      "passport_number": "123456789"
    }
  ],
  "payment": {
    "method": "credit_card",
    "amount": 350.75
  }
}
```

#### [**Response**](#response-1)

##### **Success (201 Created)**

```json
{
  "id": "BK98765",
  "flight": {
    "id": "FL1234",
    "origin": "JFK",
    "destination": "LAX",
    "departure_time": "2025-06-01T08:30:00Z",
    "arrival_time": "2025-06-01T11:30:00Z",
    "price": 350.75
  },
  "passengers": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birth": "1985-05-20",
      "passport_number": "123456789"
    }
  ],
  "status": "confirmed"
}
```

---

### [Retrieve Booking Details](#retrieve-booking-details)

#### [**GET /bookings/{bookingId}**](#get-bookingsbookingid)

Fetch details of an existing booking.

#### [**Request Parameters**](#request-parameters-1)

| Parameter | Type   | Location | Required | Description                      |
| :-------- | :----- | :------- | :------- | :------------------------------- |
| bookingId | string | Path     | Yes      | Unique identifier of the booking |

#### [**Response**](#response-2)

##### **Success (200 OK)**

```json
{
  "id": "BK98765",
  "flight": {
    "id": "FL1234",
    "origin": "JFK",
    "destination": "LAX",
    "departure_time": "2025-06-01T08:30:00Z",
    "arrival_time": "2025-06-01T11:30:00Z",
    "price": 350.75
  },
  "passengers": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birth": "1985-05-20",
      "passport_number": "123456789"
    }
  ],
  "status": "confirmed"
}
```

---

### [Cancel a Booking](#cancel-a-booking)

#### [**DELETE /bookings/{bookingId}**](#delete-bookingsbookingid)

Cancel an existing booking.

#### [**Request Parameters**](#request-parameters-2)

| Parameter | Type   | Location | Required | Description                      |
| :-------- | :----- | :------- | :------- | :------------------------------- |
| bookingId | string | Path     | Yes      | Unique identifier of the booking |

#### [**Response**](#response-3)

##### **Success (204 No Content)**

---

## [Data Models](#data-models)

### [**Flight Object**](#flight-object)

| Field          | Type   | Description                         |
| :------------- | :----- | :---------------------------------- |
| id             | string | Unique flight identifier            |
| origin         | string | Departure airport IATA code         |
| destination    | string | Arrival airport IATA code           |
| departure_time | string | Scheduled departure time (ISO 8601) |
| arrival_time   | string | Scheduled arrival time (ISO 8601)   |
| price          | number | Flight ticket price (USD)           |

### [**Booking Object**](#booking-object)

| Field      | Type   | Description                           |
| :--------- | :----- | :------------------------------------ |
| id         | string | Unique booking identifier             |
| flight     | object | Flight details                        |
| passengers | array  | List of passengers                    |
| status     | string | Booking status (confirmed, cancelled) |

### [**Passenger Object**](#passenger-object)

| Field           | Type   | Description                            |
| :-------------- | :----- | :------------------------------------- |
| first_name      | string | Passenger’s first name                 |
| last_name       | string | Passenger’s last name                  |
| date_of_birth   | string | Passenger’s date of birth (YYYY-MM-DD) |
| passport_number | string | Passport number                        |

### [**Payment Object**](#payment-object)

| Field  | Type   | Description                          |
| :----- | :----- | :----------------------------------- |
| method | string | Payment method (credit_card, paypal) |
| amount | number | Transaction amount (USD)             |

## [Rate Limits](#rate-limits)

To ensure fair usage, KongAir enforces rate limits on API requests:

-   **Standard Tier**: 1000 requests per hour
-   **Enterprise Tier**: 10,000 requests per hour

For higher limits, contact our API support team.

## [Support](#support)

For issues, feedback, or questions, reach out to **KongAir Developer Support**:

-   **Email:** [api-support@kongair.com](mailto:api-support@kongair.com)
-   **Docs:** [https://developer.kongair.com](https://developer.kongair.com)
-   **Community Forum:** [https://community.kongair.com](https://community.kongair.com)

## [Conclusion](#conclusion)

The KongAir Booking API provides a comprehensive solution for flight reservations, offering a seamless booking experience. Start integrating today to streamline air travel for your customers!