---
title: "Customer API"
description: "The Customer API provides a simple, reliable interface for retrieving KongAir customer data — profiles, contact details, payment methods, and frequent flyer numbers — from a single authenticated en..."
url: "https://portal.kongair.dev/apis/customer-api/docs/customer-api"
image: "https://portal.kongair.dev/_og/d/c_Ocean.takumi,title_Customer+API,description_~VGhlIEN1c3RvbWVyIEFQSSBwcm92aWRlcyBhIHNpbXBsZSwgcmVsaWFibGUgaW50ZXJmYWNlIGZvciByZXRyaWV2aW5nIEtvbmdBaXIgY3VzdG9tZXIgZGF0YSDigJQgcHJvZmlsZXMsIGNvbnRhY3QgZGV0YWlscywgcGF5bWVudCBtZXRob2RzLCBhbmQgZnJlcXVlbnQgZmx5ZXIgbnVtYmVycyDigJQgZnJvbSBhIHNpbmdsZSBhdXRoZW50aWNhdGVkIGVuLi4u,props_eyJ0aGVtZSI6eyJjb2xvcnMiOnsicHJpbWFyeSI6IiMyQUJEQkIifX19,p_Ii9hcGlzL2N1c3RvbWVyLWFwaS9kb2NzL2N1c3RvbWVyLWFwaSI,s_s76PKkUB-PRU_Zdi.png"
---

# Customer API

The Customer API provides a simple, reliable interface for retrieving KongAir customer data — profiles, contact details, payment methods, and frequent flyer numbers — from a single authenticated endpoint.

**Version:** 0.1.0 · **Spec:** OAS 3.1 · **Base URL:** `https://api.kong-air.com`

---

## [What You Can Do](#what-you-can-do)

**Retrieve Customer Profiles** Access a customer's full profile including their unique ID, username, display name, and contact information in a single call.

**Access Payment Methods** Fetch saved payment methods — card type, last four digits, and expiry date — for billing and checkout flows.

**Read Frequent Flyer Data** Pull frequent flyer numbers and tier status to power loyalty-driven features and personalized experiences.

---

## [Quick Start](#quick-start)

All requests to `/customer` require a bearer token in the `Authorization` header.

### [Fetch a Customer](#fetch-a-customer)

```bash
curl -X GET https://api.kong-air.com/customer \
  -H "Authorization: Bearer <your_token>" \
  -H "Accept: application/json"
```

### [Example Response](#example-response)

```json
{
  "id": "cust-9876543210",
  "username": "johndoe",
  "name": "John Doe",
  "information": {
    "email": "johndoe@example.com",
    "phone": "+1-555-000-1234",
    "frequent_flyer_number": "FF-00123456",
    "payment_methods": [
      {
        "type": "visa",
        "last_four": "4242",
        "expiry": "09/27"
      }
    ]
  }
}
```

### [Health Check](#health-check)

The `/health` endpoint is unauthenticated and Kubernetes-compatible.

```bash
curl https://api.kong-air.com/health
# { "status": "OK" }
```

---

## [Endpoints](#endpoints)

| Method | Path      | Description                                                    |
| :----- | :-------- | :------------------------------------------------------------- |
| GET    | /customer | Fetch full customer profile, payment methods, and loyalty data |
| GET    | /health   | Kubernetes liveness check — returns { "status": "OK" }         |

---

## [Reference](#reference)

| Detail         | Value                    |
| :------------- | :----------------------- |
| Base URL       | https://api.kong-air.com |
| Version        | 0.1.0                    |
| Spec Format    | OAS 3.1                  |
| Authentication | Bearer Token             |
| Support        | support@kongair.dev      |

---

> **Authentication note:** All `/customer` requests must include a valid `Authorization: Bearer <token>` header. The `/health` endpoint is open and requires no credentials.