---
title: "Bookings Service"
url: "https://dev.kong-air.com/apis/kong-air-bookings-0/versions/842ab496-7e6c-45aa-ade1-1ecb54d6988e"
---

# Bookings Service

OpenAPI specification document.

```json
{"components":{"schemas":{"Booking":{"description":"A flight Booking object","example":{"flight":{"number":"KA924","route_id":"LHR-SFO","scheduled_arrival":"2023-09-03T14:23:00Z","scheduled_departure":"2023-09-03T09:15:00Z"},"seat":"32A","ticket_number":"CDF3412"},"properties":{"flight":{"properties":{"number":{"type":"string"},"route_id":{"type":"string"},"scheduled_arrival":{"format":"date-time","type":"string"},"scheduled_departure":{"format":"date-time","type":"string"}},"type":"object"},"seat":{"type":"string"},"ticket_number":{"type":"string"}},"required":["ticket_number","flight"],"type":"object"},"BookingRequest":{"description":"A flight Booking Request object","example":{"flight_number":"KA924","seat":"32A"},"properties":{"flight_number":{"type":"string"},"seat":{"type":"string"}},"required":["flight_number"],"type":"object"},"BookingResponse":{"description":"A flight Booking Request Response object","example":{"ticket_number":"CDF3412"},"properties":{"ticket_number":{"type":"string"}},"required":["ticket_number"],"type":"object"}}},"info":{"description":"KongAir Bookings service provides customers the ability to book and retrieve flight bookings on KongAir","title":"Bookings Service","version":"0.2.0"},"openapi":"3.0.0","paths":{"/bookings":{"get":{"description":"Returns a list of bookings for the customer","operationId":"get-bookings","responses":{"200":{"content":{"application/json":{"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"}},"schema":{"items":{"$ref":"#/components/schemas/Booking"},"type":"array"}}},"description":"Successful Response"},"401":{"description":"Unauthorized"}},"summary":"Get a customers current bookings","tags":["sales"]},"post":{"description":"Creates a new booking for the customer","operationId":"post-booking","requestBody":{"content":{"application/json":{"examples":{"Example new booking request body":{"value":"{\n  \"flight_number\": \"KA924\",\n  \"seat\": \"32A\"\n}\n"}},"schema":{"$ref":"#/components/schemas/BookingRequest"}}},"description":"Defines a Booking Request"},"responses":{"201":{"content":{"application/json":{"examples":{"Example new booking response body":{"value":"{\n \"ticket_number\": \"CDF3412\"\n}\n"}},"schema":{"$ref":"#/components/schemas/BookingResponse"}}},"description":"Booking Created Successfully"},"401":{"description":"Unauthorized"},"404":{"content":{"text/plain":{"example":"Not found","schema":{"type":"string"}}},"description":"Not Found, likely for the flight_number given"}},"summary":"Create a new customer booking","tags":["sales"]}}},"servers":[{"description":"KongAir API Server","url":"https://api.kong-air.com"}],"tags":[{"description":"Customer sales endpoints","name":"sales"}]}
```