### GET /flights/airports Request Example Source: https://www.ktemia.com/docs/api/flights/airports/ Example request to search for airports by query 'austin'. The request includes optional 'country' and 'locale' fields, both set to null. ```json { "query": "austin", "country": null, "locale": null } ``` -------------------------------- ### GET /flights/airports Response Example Source: https://www.ktemia.com/docs/api/flights/airports/ Example response for the 'austin' query, returning a list of matching airports with details like code, name, city, region, country, timezone, and allAirports flag. ```json { "query": "austin", "airports": [ { "code": "AUS", "name": "Austin Bergstrom", "city": "Austin", "region": "Texas", "country": "United States", "countryCode": "US", "timezone": "America/Chicago", "allAirports": false }, { "code": "ASQ", "name": "Austin", "city": "Austin", "region": "Nevada", "country": "United States", "countryCode": "US", "timezone": "America/Los_Angeles", "allAirports": false }, { "code": "GRB", "name": "Austin-Straubel", "city": "Green Bay", "region": "Wisconsin", "country": "United States", "countryCode": "US", "timezone": "America/Chicago", "allAirports": false } ] } ``` -------------------------------- ### Request: GET /cars/results with token Source: https://www.ktemia.com/docs/api/cars/results/ Example request body for the /cars/results endpoint. The token is required to authenticate the search. ```json { "token": "eyJwIjoxLCJzIjoiMzY5Yjc0Yzc0NDI1NGYxYThjMWIyNGQ3NjgxMmZjMWUiLCJ2IjoxfQ" } ``` -------------------------------- ### Install Ktemia Skills in Claude Code Source: https://www.ktemia.com/docs/api/flights/airports/ Commands to add the Ktemia skills marketplace and install the 'ktemia' plugin in Claude Code. Requires setting the KTEMIA_API_KEY environment variable. ```bash /plugin marketplace add Ktemiaa/ktemia-skills /plugin install ktemia@ktemia ``` -------------------------------- ### Response: GET /cars/results with car listings Source: https://www.ktemia.com/docs/api/cars/results/ Example response from the /cars/results endpoint. Contains an array of car objects with details like car info, agency, pickup location, pricing, and booking options. ```json { "cars": [ { "id": "34dd91e8d2edaccb35063a37cacca7b4", "car": { "name": "Fiat 500", "class": "Mini", "classGroups": [ "small" ], "image": "https://images.turo.com/media/vehicle/images/O8c5O2cuQPGNOpcCRg0D5A.294x196.jpg", "passengers": 4, "bags": 1, "doors": 2, "transmission": "automatic", "airConditioning": true, "fuelType": "Fully electric", "sipCode": "MBAE" }, "agency": { "code": "turo", "name": "Turo" }, "pickup": { "locationId": "8e52fc9be190248c007d", "type": "NON_AIRPORT", "isAirport": false, "airportCode": null, "address": null, "city": null, "country": "US", "distance": "1.0 mi from city center", "lat": 30.275837633693175, "lng": -97.72940115400951, "rating": { "overall": 4.897200107574463, "label": "okay", "count": 0, "breakdowns": null }, "operatingHours": null }, "price": { "amount": 184, "currency": "USD", "formatted": "$184" }, "bestOption": { "provider": "ITURO", "price": { "amount": 184, "currency": "USD", "formatted": "$184" }, "perDay": { "amount": 27, "currency": "USD", "formatted": "$27" }, "paymentType": "PREPAY", "freeCancellation": true, "mileage": "1,400 total mi included", "fuelPolicy": "same-to-same" }, "bookingOptions": [ { "provider": "ITURO", "providerName": "Turo", "price": { "amount": 184, "currency": "USD", "formatted": "$184" }, "perDay": { "amount": 27, "currency": "USD", "formatted": "$27" }, "paymentType": "PREPAY", "freeCancellation": true } ], "optionCount": 1, "badges": [ { "type": "discount", "label": "16% off", "description": null } ], "discount": null, "viewRank": 1 }, { "id": "2b0173a66e41e77c3658adb6028886f7", "car": { "name": "Nissan Versa", "class": "Compact", "classGroups": [ "small" ], "image": "https://content.r9cdn.net/rimg/car-images/generic/34_sedan_gray.png?width=360", "passengers": 5, "bags": 3, "doors": 4, "transmission": "automatic", "airConditioning": true, "fuelType": "Gas", "sipCode": "CCAR" }, "agency": { "code": "europcar", "name": "Europcar" }, "pickup": { "locationId": "20015907", "type": "IN_TERMINAL", "isAirport": true, "airportCode": "AUS", "address": "Please Go To Fox Counter", "city": "Austin", "country": "US", "distance": "7.4 mi from city center", "lat": 30.19453, "lng": -97.66987, "rating": { "overall": 6, "label": "good", "count": 6, "breakdowns": null }, "operatingHours": null }, "price": { "amount": 189, "currency": "USD", "formatted": "$189" }, "bestOption": { "provider": "IEUROPCAR", "price": { "amount": 189, "currency": "USD", "formatted": "$189" }, "perDay": { "amount": 27, "currency": "USD", "formatted": "$27" }, "paymentType": "PREPAY", "freeCancellation": true, "mileage": "Unlimited miles", "fuelPolicy": "full-to-full" }, "bookingOptions": [ { "provider": "IEUROPCAR", ``` -------------------------------- ### POST /cars/search Request Example (Austin) Source: https://www.ktemia.com/docs/api/cars/search/ Example request body for the cars search endpoint. Uses pickupLocation '22863' and dates in 2026, with sortBy 'bestValue' and priceMode 'total'. Other fields are null or default. ```json { "pickupLocation": "22863", "dropoffLocation": null, "pickupDate": "2026-12-05", "dropoffDate": "2026-12-12", "pickupTime": "12:00", "dropoffTime": "12:00", "driverAge": null, "carClass": null, "transmission": null, "maxPrice": null, "sortBy": "bestValue", "sortOrder": "asc", "priceMode": "total", "country": null } ``` -------------------------------- ### POST /cars/search Response Example (Austin) Source: https://www.ktemia.com/docs/api/cars/search/ Example response for the cars search endpoint. Returns a searchToken (opaque handle) and expiresIn set to 3600 seconds. The token is valid for 60 minutes and must be passed to /cars/results and /cars/details. ```json { "searchToken": "eyJwIjoxLCJzIjoiMzY5Yjc0Yzc0NDI1NGYxYThjMWIyNGQ3NjgxMmZjMWUiLCJ2IjoxfQ", "expiresIn": 3600 } ``` -------------------------------- ### GET /flights/results Request with Token Source: https://www.ktemia.com/docs/api/flights/results/ Request body for the round trip example. Requires a token obtained from a previous search step. ```json { "token": "eyJwIjoxLCJzIjoiODRiZjZlYzU3ZGQyNDJkZDk4NmZhNzAzM2JhY2I3ODkiLCJ2IjoxfQ" } ``` -------------------------------- ### GET /flights/details Response for Multi-city Itinerary Source: https://www.ktemia.com/docs/api/flights/details/ Response for the multi-city itinerary example. Contains tripInfo with tripType 'multiCity', three legs with segments, and bookingOptions with provider details and bag fees. ```json { "resultId": "84604222a90ff5883c97f139be649c27", "tripInfo": { "tripType": "multiCity", "isDomestic": true, "isMultiAirport": false }, "legs": [ { "departure": "2026-12-03T17:29:00", "arrival": "2026-12-03T23:12:00", "duration": 523, "stops": 1, "segments": [ { "airline": "AS", "flightNumber": "41", "origin": "JFK", "destination": "SFO", "departure": "2026-12-03T17:29:00", "arrival": "2026-12-03T21:05:00", "duration": 396, "aircraft": "Boeing 737 MAX 9" }, { "airline": "AS", "flightNumber": "661", "origin": "SFO", "destination": "LAX", "departure": "2026-12-03T21:45:00", "arrival": "2026-12-03T23:12:00", "duration": 87, "aircraft": "Boeing 737-900 (winglets)" } ] }, { "departure": "2026-12-10T13:50:00", "arrival": "2026-12-10T15:16:00", "duration": 86, "stops": 0, "segments": [ { "airline": "AS", "flightNumber": "465", "origin": "LAX", "destination": "SFO", "departure": "2026-12-10T13:50:00", "arrival": "2026-12-10T15:16:00", "duration": 86, "aircraft": "Boeing 737 MAX 9" } ] }, { "departure": "2026-12-17T09:10:00", "arrival": "2026-12-17T22:29:00", "duration": 619, "stops": 1, "segments": [ { "airline": "AS", "flightNumber": "3178", "origin": "SFO", "destination": "PSP", "departure": "2026-12-17T09:10:00", "arrival": "2026-12-17T10:51:00", "duration": 101, "aircraft": "Embraer 175" }, { "airline": "AS", "flightNumber": "242", "origin": "PSP", "destination": "JFK", "departure": "2026-12-17T14:14:00", "arrival": "2026-12-17T22:29:00", "duration": 315, "aircraft": "Boeing 737-800 (winglets)" } ] } ], "bookingOptions": [ { "providerCode": "AS", "providerUrl": "https://www.alaskaair.com/search/cart?FT=MC&F1=JFK%7CSFO%7C12%2F03%2F2026%7C41%2CAS%7CS%7CN%7CFBX%3AOH2OAJBN&F2=SFO%7CLAX%7C12%2F03%2F2026%7C661%2CAS%7CS%7CN%7CFBX%3AOH2OAJBN&F3=LAX%7CSFO%7C12%2F10%2F2026%7C465%2CAS%7CS%7CN%7CFBX%3AGH2OGVBN&F4=SFO%7CPSP%7C12%2F17%2F2026%7C3178%2CAS%7CS%7CN%7CFBX%3AOH2OAJBN&F5=PSP%7CJFK%7C12%2F17%2F2026%7C242%2CAS%7CS%7CN%7CFBX%3AOH2OAJBN&A=1&C=0&L=0&RT=false&ShoppingMethod=multicity&shoppingmethod=standard&requesttype=none", "providerDomain": "www.alaskaair.com", "price": 463, "currency": "USD", "formattedPrice": "$463", "totalPrice": 463, "formattedTotalPrice": "$463", "bagFees": { "policy": [ { "type": "personalItem", "restrictions": {} }, { "type": "carryOn", "restrictions": { "dimensions": "Up to 21 x 13 x 8in" } }, { "type": "checked", "restrictions": { "dimensions": "Up to 62in total" } } ] }, "segmentFares": [ { "cabin": "economy", "quality": [ { "type": "aircraft", "label": "Boeing 737 MAX 9 (Narrow-body jet)" }, { "type": "wifi", "label": "Streaming capable Wi-Fi (fee)" }, { "type": "entertainment", "label": "Streaming entertainment" }, { "type": "power", "label": "Power & USB outlets" }, { "type": "seat", "label": "31\" seat pitch • 3-3 seat layout" }, { "type": "food", "label": "Preorder light meal (fee)" } ] }, { "cabin": "economy", ``` -------------------------------- ### GET /flights/results Response with Flight Data Source: https://www.ktemia.com/docs/api/flights/results/ Response payload for the round trip example, containing flight legs, segments, and booking options. Includes provider codes and pricing details. ```json { "flights": [ { "id": "07804f9e1b83425f0e30951ae0c29a9a", "legs": [ { "departure": "2026-12-03T21:15:00", "arrival": "2026-12-04T09:15:00", "duration": 420, "stops": 0, "segments": [ { "airline": "AA", "flightNumber": "104", "origin": "JFK", "destination": "LHR", "departure": "2026-12-03T21:15:00", "arrival": "2026-12-04T09:15:00", "duration": 420, "aircraft": "Boeing 787-9 Dreamliner" } ] }, { "departure": "2026-12-10T19:20:00", "arrival": "2026-12-10T22:25:00", "duration": 485, "stops": 0, "segments": [ { "airline": "AA", "flightNumber": "6942", "origin": "LHR", "destination": "JFK", "departure": "2026-12-10T19:20:00", "arrival": "2026-12-10T22:25:00", "duration": 485, "aircraft": "Boeing 777" } ] } ], "bookingOptions": [ { "providerCode": "AA", "price": 830, "currency": "USD", "formattedPrice": "$830", "totalPrice": 1659, "formattedTotalPrice": "$1,659", "isDirect": true, "isFreeCancellation": true }, { "providerCode": "AA", "price": 1070, "currency": "USD", "formattedPrice": "$1,070", "totalPrice": 2139, "formattedTotalPrice": "$2,139", "isDirect": true, "isFreeCancellation": true } ], "totalProviders": 1, "isBest": true, "isCheapest": false }, { "id": "26253ca87e823ccb9ef262c410c733c7", "legs": [ { "departure": "2026-12-03T08:05:00", "arrival": "2026-12-03T20:00:00", "duration": 415, "stops": 0, "segments": [ { "airline": "AA", "flightNumber": "6939", "origin": "JFK", "destination": "LHR", "departure": "2026-12-03T08:05:00", "arrival": "2026-12-03T20:00:00", "duration": 415, "aircraft": "Boeing 777" } ] }, { "departure": "2026-12-10T18:05:00", "arrival": "2026-12-10T21:10:00", "duration": 485, "stops": 0, "segments": [ { "airline": "AA", "flightNumber": "6940", "origin": "LHR", "destination": "JFK", "departure": "2026-12-10T18:05:00", "arrival": "2026-12-10T21:10:00", "duration": 485, "aircraft": "Boeing 777" } ] } ], "bookingOptions": [ { "providerCode": "AA", "price": 830, "currency": "USD", "formattedPrice": "$830", "totalPrice": 1659, "formattedTotalPrice": "$1,659", "isDirect": true, "isFreeCancellation": true }, { "providerCode": "AA", "price": 1070, "currency": "USD", "formattedPrice": "$1,070", "totalPrice": 2139, "formattedTotalPrice": "$2,139", "isDirect": true, "isFreeCancellation": true } ], "totalProviders": 1, "isBest": false, "isCheapest": true }, { "id": "776442bf2801c050166cb6a027ef8bbd", "legs": [ { "departure": "2026-12-03T21:15:00", "arrival": "2026-12-04T09:15:00", "duration": 420, "stops": 0, "segments": [ { "airline": "AA", "flightNumber": "104", "origin": "JFK", "destination": "LHR", "departure": "2026-12-03T21:15:00", "arrival": "2026-12-04T09:15:00", "duration": 420, "aircraft": "Boeing 787-9 Dreamliner" } ] }, { "departure": "2026-12-10T19:20:00", "arrival": "2026-12-10T22:25:00", "duration": 485, "stops": 0, "segments": [ { "airline": "AA", "flightNumber": "6942", "origin": "LHR", "destination": "JFK", "departure": "2026-12-10T19:20:00", "arrival": "2026-12-10T22:25:00", "duration": 485, "aircraft": "Boeing 777" } ] } ], "bookingOptions": [ { "providerCode": "AA", "price": 830, "currency": "USD", "formattedPrice": "$830", "totalPrice": 1659, "formattedTotalPrice": "$1,659", "isDirect": true, "isFreeCancellation": true }, { "providerCode": "AA", "price": 1070, "currency": "USD", "formattedPrice": "$1,070", "totalPrice": 2139, "formattedTotalPrice": "$2,139", "isDirect": true, "isFreeCancellation": true } ], "totalProviders": 1, "isBest": false, "isCheapest": false } ] } ``` -------------------------------- ### Hotel review object JSON example Source: https://www.ktemia.com/docs/api/objects/hotel-review/ Example of a hotel review object with all attributes. The score is on a 0–10 scale, and the URL opens the review on the source site. The comment is null when the review is split into positive and negative. ```json { "id": "r7tKjqEBLNjwf3gzyjSF", "score": 10, "label": "Excellent", "date": "2026-10", "author": "Terence", "positive": "Staff went over and above and a beautiful pleace", "negative": "Dining room was dusty and dirts where they sat us in the corner.", "comment": null, "source": "Booking.com", "url": "https://www.booking.com/hotel/gb/threadneedles-london.en.html?tab=4" } ``` -------------------------------- ### GET /cars/results Source: https://www.ktemia.com/docs/api/cars/results/ Read a page of a search identified by its token. Pass the searchToken from /cars/search as the token query parameter to get page 1. Each response that has another page includes nextToken. ```APIDOC ## [GET] /cars/results ### Description Read a page of a search identified by its token. Pass the `searchToken` from `/cars/search` as the `token` query parameter to get page 1. Each response that has another page includes `nextToken`. This call usually answers in 1–4 seconds. ### Method GET ### Endpoint /cars/results ### Parameters #### Query Parameters - **token** (string) - Required - A `searchToken` from `/cars/search` for page 1, or a `nextToken` from the previous page. There is no page number to set. ### Response #### Success Response (200) - **cars** (array of objects) - Required - Up to 20 cars. - **id** (string) - Required - Opaque identifier of this car. Pass it as `resultId` to `/cars/details`. - **car** (object) - Optional - The vehicle. - **name** (string) - Optional - Vehicle name as listed, for example `Nissan Versa`. - **class** (string) - Optional - Display class, for example `Compact` or `Intermediate SUV`. - **classGroups** (array of strings) - Optional - Groups this car belongs to, such as `small` or `suv`. Matches `carClass` on a new search. - **image** (string) - Optional - Image URL. - **passengers** (integer) - Optional - Seat count. - **bags** (integer) - Optional - Bag count. - **doors** (integer) - Optional - Door count. - **transmission** (string) - Optional - `automatic` or `manual`. - **airConditioning** (boolean) - Optional - True when the car has air conditioning. - **fuelType** (string) - Optional - Fuel label, for example `Gas` or `Fully electric`. - **sipCode** (string) - Optional - ACRISS / SIP code when the supplier publishes one. - **agency** (object) - Optional - The rental company that owns the car. - **code** (string) - Optional - Agency code. - **name** (string) - Optional - Display name, for example `Europcar`. - **pickup** (object) - Optional - The pickup desk. - **locationId** (string) - Optional - Desk id. Different from the city id you sent as `pickupLocation`. - **type** (string) - Optional - Desk type, for example `IN_TERMINAL` or `NON_AIRPORT`. - **isAirport** (boolean) - Optional - True when the desk is at an airport. - **airportCode** (string) - Optional - IATA airport code when `isAirport` is true. - **address** (string) - Optional - Street address when the supplier publishes one. - **city** (string) - Optional - City of the desk. - **country** (string) - Optional - ISO 3166-1 alpha-2 country code. - **distance** (string) - Optional - Distance from the city centre, already formatted. - **lat** (number) - Optional - Latitude. - **lng** (number) - Optional - Longitude. - **rating** (object) - Optional - Desk reviews. - **overall** (number) - Optional - Desk score on a 0–10 scale. - **label** (string) - Optional - Short label for the score, for example `good`. - **count** (integer) - Optional - How many reviews the score is based on. - **breakdowns** (array of objects) - Optional - Per-category scores when the supplier publishes them. - **operatingHours** (array of objects) - Optional - Opening hours. `open` and `close` are `HHMM` integers, for example `730` is 07:30. - **price** (object) - Optional - Lowest total price on this car. - **amount** (number) - Optional - Numeric amount in the country’s native currency. - **currency** (string) - Optional - ISO 4217 code of that country’s native currency. - **formatted** (string) - Optional - Same amount, already formatted for display. - **bestOption** (object) - Optional - The cheapest seller for this car. Details expands every seller. - **provider** (string) - Optional - Seller code of the cheapest option. - **price** (object) - Optional - Total price. - **amount** (number) - Optional - Numeric amount in the country’s native currency. - **currency** (string) - Optional - ISO 4217 code of that country’s native currency. - **formatted** (string) - Optional - Same amount, already formatted for display. - **perDay** (object) - Optional - Average daily price. - **amount** (number) - Optional - Numeric amount in the country’s native currency. - **currency** (string) - Optional - ISO 4217 code of that country’s native currency. - **formatted** (string) - Optional - Same amount, already formatted for display. ``` -------------------------------- ### Request: GET /cars/locations with query 'austin' Source: https://www.ktemia.com/docs/api/cars/locations/ Example request body for the GET /cars/locations endpoint. The query parameter is set to 'austin' to search for locations matching that name. ```json { "query": "austin" } ``` -------------------------------- ### Authentication - API Key Header Source: https://www.ktemia.com/docs/api/ Every request requires an API key. Send it in the X-API-Key header. Missing or invalid keys return 401 with an error envelope. ```APIDOC ## [GET] / (Authentication) ### Description Every request requires an API key. Create one in the dashboard, then send it on every call via the X-API-Key header. ### Method GET ### Endpoint / ### Parameters #### Headers - **X-API-Key** (string) - Required - Your API key. ### Response #### Success Response (200) - No specific success response documented. #### Error Response (401) - **success** (boolean) - false - **error** (object) - Contains code and message. - **code** (string) - MISSING_API_KEY or INVALID_API_KEY - **message** (string) - Error message. - **data** (null) - Always null. ### Request Example No request example provided. ### Response Example No response example provided. ``` -------------------------------- ### GET /flights/airports Request for London Source: https://www.ktemia.com/docs/api/flights/airports/ Example request body for the GET /flights/airports endpoint. The query is set to "london" with null country and locale, returning a 200 status. ```json { "query": "london", "country": null, "locale": null } ``` -------------------------------- ### Install Ktemia Skills in Claude Code Source: https://www.ktemia.com/docs/api/flights/search/ Adds the Ktemia skills plugin to Claude Code. Requires setting the KTEMIA_API_KEY environment variable. The flight skill looks up airport codes, asks when a name matches several cities, and returns each seller's booking URL; it does not book tickets. ```shell /plugin marketplace add Ktemiaa/ktemia-skills /plugin install ktemia@ktemia ``` -------------------------------- ### GET /flights/airports Response for London Source: https://www.ktemia.com/docs/api/flights/airports/ Example response for the GET /flights/airports endpoint with query "london". Returns a list of airports including an aggregate entry (LON) and individual airports (LHR, LGW, LCY, LTN, STN) with details like city, country, and timezone. ```json { "query": "london", "airports": [ { "code": "LON", "name": "All airports", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "timezone": "Europe/London", "allAirports": true }, { "code": "LHR", "name": "Heathrow", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "timezone": "Europe/London", "allAirports": false }, { "code": "LGW", "name": "Gatwick", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "timezone": "Europe/London", "allAirports": false }, { "code": "LCY", "name": "London City", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "timezone": "Europe/London", "allAirports": false }, { "code": "LTN", "name": "Luton", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "timezone": "Europe/London", "allAirports": false }, { "code": "STN", "name": "Stansted", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "timezone": "Europe/London", "allAirports": false } ] } ``` -------------------------------- ### Request: Recent reviews for hotel 5782 Source: https://www.ktemia.com/docs/api/hotels/reviews/ Example request body for GET /hotels/reviews. Requires a hotelId (digits only) and optionally sortBy. Defaults to recent if sortBy omitted. ```json { "hotelId": "5782", "sortBy": "recent" } ``` -------------------------------- ### POST /cars/search Source: https://www.ktemia.com/docs/api/cars/search/ Starts a rental car search for a pickup location and dates. Returns a search token, not results. Requires an X-API-Key header for authentication. ```APIDOC ## POST /cars/search ### Description Starts a rental car search for a pickup location and dates. Returns a search token, not results. Requires an X-API-Key header for authentication. ### Method POST ### Endpoint /cars/search ### Parameters #### Request Body - **pickupLocation** (string) - Required - The location ID, not a name. Look it up with the Search locations endpoint. - **pickupDate** (string) - Required - The pickup date. - **dropoffDate** (string) - Required - The dropoff date. - **dropoffLocation** (string) - Optional - The dropoff location ID, only when the car is returned somewhere else. - **country** (string) - Optional - The market country code (e.g., GB, DE, US). Determines currency. Defaults to US. - **providers** (array of strings) - Optional - Booking site names to filter by, e.g., ["Expedia"]. Up to 10. - **agencies** (array of strings) - Optional - Rental company codes to filter by, e.g., ["avis"]. Up to 10. ### Response #### Success Response (200) - **searchToken** (string) - A token to use for retrieving results. #### Error Response (404) - **NO_RESULTS** - Returned when there are no cars matching the search. ``` -------------------------------- ### Response: GET /cars/locations with query 'austin' Source: https://www.ktemia.com/docs/api/cars/locations/ Example response for the GET /cars/locations endpoint with query 'austin'. Returns a list of locations matching the query, each with locationId, name, city, country, countryCode, locationType, airportCode, and timezone. The response includes both city and airport locations, with some airportCode values being null. ```json { "query": "austin", "locations": [ { "locationId": "22863", "name": "Austin, Texas, United States", "city": "Austin", "country": "United States", "countryCode": "US", "locationType": "city", "airportCode": "AUS", "timezone": "America/Chicago" }, { "locationId": "22863", "name": "Austin Bergstrom, Austin, Texas, United States, (AUS)", "city": "Austin", "country": "United States", "countryCode": "US", "locationType": "airport", "airportCode": "AUS", "timezone": "America/Chicago" }, { "locationId": "34419", "name": "Austin, Minnesota, United States", "city": "Austin", "country": "United States", "countryCode": "US", "locationType": "city", "airportCode": "AUM", "timezone": "America/Chicago" }, { "locationId": "29818", "name": "Austin, Nevada, United States", "city": "Austin", "country": "United States", "countryCode": "US", "locationType": "city", "airportCode": "ASQ", "timezone": "America/Los_Angeles" }, { "locationId": "30031", "name": "Austin, Arkansas, United States", "city": "Austin", "country": "United States", "countryCode": "US", "locationType": "city", "airportCode": null, "timezone": "America/Chicago" }, { "locationId": "12514", "name": "Austin, Chicago, Illinois, United States", "city": "Chicago", "country": "United States", "countryCode": "US", "locationType": "city", "airportCode": null, "timezone": "America/Chicago" } ] } ``` -------------------------------- ### GET /flights/details Request for Multi-city Itinerary Source: https://www.ktemia.com/docs/api/flights/details/ Request payload for the multi-city itinerary example. Uses a token and resultId to retrieve flight details. The response returns tripInfo, legs, and bookingOptions. ```json { "token": "eyJwIjoxLCJzIjoiZjVmZDc1YzM4NTM5NDhkZGE2ZjAyZjE3MDQ3ZjNmM2EiLCJ2IjoxfQ", "resultId": "84604222a90ff5883c97f139be649c27" } ``` -------------------------------- ### GET /key Source: https://www.ktemia.com/docs/api/key/ Retrieves information about the API key sent via X-API-Key, including its plan, rate limits, and monthly usage. This endpoint is unmetered and does not consume quota. ```APIDOC ## [GET] /key ### Description Retrieves information about the API key sent via X-API-Key, including its plan, rate limits, and monthly usage. This endpoint is unmetered and does not consume quota. ### Method GET ### Endpoint /key ### Parameters #### Query Parameters - None documented. ### Response #### Success Response (200) - **key.fingerprint** (string) - Short prefix for identifying the key in logs. - **key.status** (string) - Status of the key (e.g., "active"). - **key.createdAt** (string) - Creation timestamp of the key. - **plan.name** (string) - Name of the plan (e.g., "free"). - **plan.monthlyQuota** (integer) - Monthly request quota. - **plan.requestsPerSecond** (integer) - Rate limit per second. - **plan.burst** (integer) - Burst limit. - **usage.month** (string) - Current usage month (e.g., "2026-11"). - **usage.used** (integer) - Number of requests used this month. - **usage.remaining** (integer) - Number of requests remaining this month. - **usage.resetsAt** (string) - Timestamp when the usage month resets. - **usage.scope** (string) - Scope of usage: "account" or "key". - **metered** (boolean) - Whether this endpoint is metered (always false). #### Response Example ```json { "key": { "fingerprint": "63505517", "status": "active", "createdAt": "2026-11-02T09:14:00+00:00" }, "plan": { "name": "free", "monthlyQuota": 100, "requestsPerSecond": 2, "burst": 5 }, "usage": { "month": "2026-11", "used": 37, "remaining": 63, "resetsAt": "2026-12-01T00:00:00+00:00", "scope": "account" }, "metered": false } ``` ``` -------------------------------- ### GET /hotels/details Source: https://www.ktemia.com/docs/api/hotels/details/ Expands one hotel into booking options with provider URLs. Requires a token and resultId from a previous search, and returns booking links for each seller that resolved. ```APIDOC ## [GET] /hotels/details ### Description Expand one hotel into booking options with provider URLs. This call usually answers in 3–8 seconds and includes a booking link for each seller that resolved. ### Method GET ### Endpoint https://api.ktemia.com/hotels/details ### Parameters #### Query Parameters - **token** (string) - Required - Any token of the search that produced the hotel - the original `searchToken` or a later `nextToken`. - **resultId** (string) - Required - The `id` of a hotel from `/hotels/results` for this same token. ### Response #### Success Response (200) - **bookingOptions[].providerUrl** (string) - URL that opens the seller’s site with the stay filled in. `null` means that seller did not resolve; the others on the same hotel are still usable. - **reviews.recent** (array) - Up to five of the newest guest reviews, on the same 0–10 scale as the hotel score. ### Authentication Send header `X-API-Key` on every request. ``` -------------------------------- ### Response: GET /hotels/locations for London Source: https://www.ktemia.com/docs/api/hotels/locations/ Example response for the London query. Returns an array of locations with fields like locationId, name, city, region, country, countryCode, locationType, lat, lng. Empty when nothing matches. ```json { "query": "London", "locations": [ { "locationId": "29230", "name": "London, England, United Kingdom", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "locationType": "city", "lat": 51.49916450106749, "lng": -0.12525865742190945 }, { "locationId": "174457", "name": "Heathrow, London, England, United Kingdom, (LHR)", "city": "London", "region": "England", "country": "United Kingdom", "countryCode": "GB", "locationType": "airport", "lat": 51.47115, "lng": -0.4564899999999999 }, { "locationId": "62830", "name": "London, Ontario, Canada", "city": "London", "region": "Ontario", "country": "Canada", "countryCode": "CA", "locationType": "city", "lat": 42.98339, "lng": -81.23304 } ] } ``` -------------------------------- ### Delta airline search request and response Source: https://www.ktemia.com/docs/api/flights/airlines/ Example request and response for GET /flights/airlines with query "delta". Returns 200 with the DL code for Delta. The request includes optional country and locale fields set to null. ```json { "query": "delta", "country": null, "locale": null } ``` ```json { "query": "delta", "airlines": [ { "code": "DL", "name": "Delta", "logo": "https://content.r9cdn.net/rimg/provider-logos/airlines/h/DL.png?crop=false&width=71&height=25&fallback=default1.png" } ] } ```