---
title: "Bookings Service"
url: "https://kongair.kong-sales-engineering.com/apis/bookings/versions/e76ff5ce-5835-40ee-817e-077abce466fd"
---

# Bookings Service

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 Service"},"servers":[{"url":"https://shared-services.kong-sales-engineering.com/kongair","description":"KongAir API Server"}],"paths":{"/bookings":{"get":{"tags":["sales"],"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":"[{\n  \"ticket_number\": \"CDF3412\",\n  \"seat\": \"32A\",\n  \"flight\": {\n    \"number\": \"KA924\",\n    \"route_id\": \"LHR-SFO\",\n    \"scheduled_departure\": \"2023-09-03T09:15:00Z\",\n    \"scheduled_arrival\": \"2023-09-03T14:23:00Z\"\n  }\n}]\n"}}}}},"401":{"description":"Unauthorized"}}},"post":{"tags":["sales"],"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":"{\n \"ticket_number\": \"CDF3412\"\n}\n"}}}}},"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":"{\n  \"flight_number\": \"KA924\",\n  \"seat\": \"32A\"\n}\n"}}}}}}}},"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"]}},"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}}},"security":[{"basicAuth":[]}]}
```