---
title: "Bookings API"
url: "https://portal.kongair.dev/apis/bookings-api/versions/2638ca26-096b-48fd-8ea1-c61d6cf8a701"
---

# Bookings API

OpenAPI specification document.

```json
{"openapi":"3.0.0","info":{"description":"KongAir Bookings service provides customers the ability to book and retrieve flight bookings on KongAir","version":"1.0.0","title":"Bookings API","contact":{"name":"Support","email":"support@kongair.dev"}},"servers":[{"url":"https://kong-963acb42fausl4p8k.kongcloud.tech","description":"KongAir API Server (CORS)"},{"url":"https://api.kong-air.com","description":"KongAir API Server"}],"paths":{"/health":{"get":{"summary":"Health check endpoint for Kubernetes","description":"Endpoint that returns the service health status.","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"OK"}}}}}},"500":{"description":"Service is unhealthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"unhealthy"}}}}}}}}},"/bookings":{"get":{"summary":"Get a customers current bookings","operationId":"get-bookings","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Booking"}},"examples":{"Example Bookings list response":{"value":[{"ticket_number":"CDF3412","seat":"32A","flight":{"number":"KA924","route_id":"LHR-SFO","scheduled_departure":"2023-09-03T09:15:00Z","scheduled_arrival":"2023-09-03T14:23:00Z"}}]}}}}},"401":{"description":"Unauthorized"}}},"post":{"summary":"Create a new customer booking","operationId":"post-booking","responses":{"201":{"description":"Booking Created Successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingResponse"},"examples":{"Example new booking response body":{"value":{"ticket_number":"CDF3412"}}}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not Found, likely for the flight_number given","content":{"text/plain":{"schema":{"type":"string"},"example":"Not found"}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingRequest"},"examples":{"Example new booking request body":{"value":{"flight_number":"KA924","seat":"32A"}}}}}}}}},"components":{"schemas":{"Booking":{"type":"object","properties":{"ticket_number":{"type":"string"},"flight":{"type":"object","properties":{"number":{"type":"string"},"route_id":{"type":"string"},"scheduled_departure":{"type":"string","format":"date-time"},"scheduled_arrival":{"type":"string","format":"date-time"}}},"seat":{"type":"string"}},"required":["ticket_number","flight"]},"BookingRequest":{"type":"object","properties":{"flight_number":{"type":"string"},"seat":{"type":"string"}},"required":["flight_number"]},"BookingResponse":{"type":"object","properties":{"ticket_number":{"type":"string"}},"required":["ticket_number"]}}}}
```