---
title: "Destinations Service"
url: "https://dev.kong-air.com/apis/kong-air-destinations-0/versions/d8c1e150-7b03-4f7f-84ba-fab552b9d886"
---

# Destinations Service

OpenAPI specification document.

```json
{"components":{"schemas":{"Destination":{"description":"Represents a destination city & airport.","example":{"destination":"San Francisco","id":"SFO","image":"https://testimages.com/SFO"},"properties":{"city":{"description":"City name for the destination.","example":"San Francisco","type":"string"},"id":{"description":"Unique identifier for the airport.","example":"SFO","type":"string"},"image":{"description":"Image link for the destination.","example":"https://testimages.com/SFO","type":"string"}},"required":["id","city","image"],"type":"object"}}},"info":{"description":"KongAir Destinations service provides the registered airport & city destinations KongAir flies tro.","title":"Destinations Service","version":"0.1.0"},"openapi":"3.0.0","paths":{"/destinations":{"get":{"description":"Returns all the destinations KongAir is currently registered to fly.","operationId":"getAllDestinations","responses":{"200":{"content":{"application/json":{"examples":{"multipleDestinationsExample":{"value":[{"airport_code":"SFO","id":"SFO","image":"https://testimages.com/SFO"},{"airport_code":"SIN","id":"SIN","image":"https://testimages.com/SIN"}]}},"schema":{"items":{"$ref":"#/components/schemas/Destination"},"type":"array"}}},"description":"Successful response with the registered destinations."}},"summary":"Request all KongAir destinations","tags":["Destinations"]}},"/destinations/{id}":{"get":{"description":"Returns a specific destination for a given Airport ID / Code.","operationId":"getDestinationById","parameters":[{"description":"Destination id is unique identifier for the destination airport.","example":"SIN","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"destinationExample":{"value":{"city":"Singapore","id":"SIN","image":"https://testimages.com/SIN"}}},"schema":{"$ref":"#/components/schemas/Destination"}}},"description":"Successful response with the found destination."},"404":{"content":{"application/json":{"examples":{"notFoundExample":{"value":{"message":"Destination not found."}}},"schema":{"properties":{"message":{"example":"Destination not found","type":"string"}},"type":"object"}}},"description":"Destination not found."}},"summary":"Request a specific KongAir destination by id (e.g., SFO)","tags":["Destinations"]}},"/health":{"get":{"description":"Endpoint that returns the service health status","operationId":"getHealthStatus","responses":{"200":{"content":{"application/json":{"examples":{"healthyExample":{"value":{"status":"OK"}}},"schema":{"properties":{"status":{"example":"OK","type":"string"}},"type":"object"}}},"description":"Service is healthy."},"500":{"content":{"application/json":{"examples":{"unhealthyExample":{"value":{"status":"unhealthy"}}},"schema":{"properties":{"status":{"example":"unhealthy","type":"string"}},"type":"object"}}},"description":"Service is unhealthy."}},"summary":"Health check endpoint for Kubernetes","tags":["Health"]}}},"servers":[{"description":"KongAir API Server","url":"https://api.kong-air.com"}],"tags":[{"description":"Endpoints for checking the service health","name":"Health"},{"description":"Endpoints related to KongAir flight destinations","name":"Destinations"}]}
```