---
title: "Passenger"
url: "https://portal.kongair.dev/guides/passengers"
image: "https://portal.kongair.dev/_og/d/c_Ocean.takumi,title_Passenger,props_eyJ0aGVtZSI6eyJjb2xvcnMiOnsicHJpbWFyeSI6IiMyQUJEQkIifX19,p_Ii9ndWlkZXMvcGFzc2VuZ2VycyI,s_Ux9fYFSnoFnaRH_q.png"
---

# KongAir Passenger API

Obtain API keys

Learn more about our process to obtain API keys before proceeding

[Get API keys](https://portal.kongair.dev/get-api-keys)

## [Introduction](#introduction)

Welcome to the **KongAir Passenger API**. KongAir is committed to delivering seamless, world-class travel experiences by leveraging modern technology. Our Passenger API enables authorized applications to access passenger details, loyalty program status, recent flight history, and transaction records. This API is designed for use by travel partners, airport systems, and customer service platforms.

## [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 Passenger Information](#retrieve-passenger-information)

#### [**GET /passengers/{customerId}**](#get-passengerscustomerid)

Fetch detailed information about a specific passenger using their unique customer ID.

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

| Parameter  | Type   | Location | Required | Description                          |
| :--------- | :----- | :------- | :------- | :----------------------------------- |
| customerId | string | Path     | Yes      | Unique customer ID (e.g., CUST12345) |

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

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

```json
{
  "customer_id": "CUST12345",
  "first_name": "John",
  "middle_name": "Michael",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "phone_number": "+1-555-123-4567",
  "address": {
    "street": "123 Main St",
    "city": "Los Angeles",
    "state": "CA",
    "postal_code": "90001",
    "country": "USA"
  },
  "employer": "Acme Corp",
  "loyalty_status": {
    "tier": "Gold",
    "points_balance": 25000,
    "status_valid_until": "2026-12-31"
  },
  "recent_flights": [
    {
      "flight_number": "KA5678",
      "origin": "JFK",
      "destination": "LAX",
      "departure_date": "2024-05-15",
      "class": "Business",
      "seat_number": "12A"
    }
  ],
  "recent_purchases": [
    {
      "purchase_id": "PUR78901",
      "description": "Extra baggage allowance",
      "amount": 50.00,
      "purchase_date": "2025-02-20T14:30:00Z"
    }
  ]
}
```

##### **Error Responses**

| Status Code | Description                |
| :---------- | :------------------------- |
| 400         | Invalid customer ID format |
| 404         | Passenger not found        |
| 500         | Internal server error      |

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

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

| Field            | Type   | Description                                |
| :--------------- | :----- | :----------------------------------------- |
| customer_id      | string | Unique customer identifier                 |
| first_name       | string | Passenger's first name                     |
| middle_name      | string | Passenger's middle name (if available)     |
| last_name        | string | Passenger's last name                      |
| email            | string | Passenger's email address                  |
| phone_number     | string | Contact phone number                       |
| address          | object | Full address details                       |
| employer         | string | Employer name (if available)               |
| loyalty_status   | object | Details on passenger's loyalty program     |
| recent_flights   | array  | List of past flights                       |
| recent_purchases | array  | List of recent purchases made with KongAir |

### [**Loyalty Status Object**](#loyalty-status-object)

| Field              | Type    | Description                                           |
| :----------------- | :------ | :---------------------------------------------------- |
| tier               | string  | Loyalty program tier (Bronze, Silver, Gold, Platinum) |
| points_balance     | integer | Current loyalty points balance                        |
| status_valid_until | string  | Expiry date of the current status                     |

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

| Field          | Type   | Description                             |
| :------------- | :----- | :-------------------------------------- |
| flight_number  | string | Flight identifier                       |
| origin         | string | Departure airport IATA code             |
| destination    | string | Arrival airport IATA code               |
| departure_date | string | Date of flight (YYYY-MM-DD)             |
| class          | string | Ticket class (Economy, Business, First) |
| seat_number    | string | Assigned seat number                    |

### [**Purchase Object**](#purchase-object)

| Field         | Type   | Description                          |
| :------------ | :----- | :----------------------------------- |
| purchase_id   | string | Unique purchase identifier           |
| description   | string | Description of the purchase          |
| amount        | number | Transaction amount (USD)             |
| purchase_date | string | Date and time of purchase (ISO 8601) |

## [Usage Example](#usage-example)

Here’s how a client application might retrieve passenger details:

```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -X GET "https://api.kongair.com/v1/passengers/CUST12345"
```

## [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 Passenger API provides comprehensive and secure access to passenger profiles, loyalty status, and recent transactions. Whether you're enhancing customer service or integrating travel solutions, KongAir empowers your applications with rich passenger data. Start integrating today and elevate your travel experiences with KongAir!