Kiwi.com API

POST https://cotlet.dev/api/v1/kiwi-com/search_flights

Searches Kiwi.com flights for one-way or round trips and returns the flights Kiwi.com finds, each with a link to book on Kiwi.com. Date flexibility goes up to 3 days either side. It does not need your trips, so it works before you book anything.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/search_flights \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"from","to":"to","departure_date":"2026-10-01"}'

result = client.call("kiwi-com", "search_flights", {"from":"from","to":"to","departure_date":"2026-10-01"})

const result = await cotlet.call('kiwi-com', 'search_flights', {"from":"from","to":"to","departure_date":"2026-10-01"});

cotlet call kiwi-com search_flights --data '{"from":"from","to":"to","departure_date":"2026-10-01"}'

Example response

{
  "flights": [
    {
      "price": {
        "amount": 128,
        "currency": "EUR"
      },
      "route": "PRG-LIS",
      "departs": "2026-11-12T06:40:00+01:00",
      "arrives": "2026-11-12T09:10:00+00:00",
      "duration": "4h 30m",
      "stops": 0,
      "booking_url": "https://www.kiwi.com/en/booking?token=example1"
    },
    {
      "price": {
        "amount": 112,
        "currency": "EUR"
      },
      "route": "PRG-LIS",
      "departs": "2026-11-13T13:55:00+01:00",
      "arrives": "2026-11-13T18:20:00+00:00",
      "duration": "5h 25m",
      "stops": 1,
      "booking_url": "https://www.kiwi.com/en/booking?token=example2"
    }
  ]
}

POST https://cotlet.dev/api/v1/kiwi-com/list_trips

Returns the trips on your account. Each trip shows the booking number, route, departure, passenger count and documents_missing. Use trip_id in every other trip tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/list_trips \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("kiwi-com", "list_trips")

const result = await cotlet.call('kiwi-com', 'list_trips');

cotlet call kiwi-com list_trips

Example response

{
  "trips": [
    {
      "trip_id": "512834907",
      "route": "PRG-BCN-PRG",
      "departs": "2026-11-14T07:20:00+01:00",
      "passengers": 1,
      "documents_missing": true
    },
    {
      "trip_id": "734120655",
      "route": "PRG-BER",
      "departs": "2026-12-02T09:05:00+01:00",
      "passengers": 2,
      "documents_missing": false
    }
  ]
}

POST https://cotlet.dev/api/v1/kiwi-com/get_trip

Returns the full trip as shown on its booking page: each flight with its flight_id, each passenger with passenger_id, bags and seats already booked, check-in status, and the travel documents Kiwi.com still needs per passenger. Use the IDs in the write tools.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/get_trip \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"trip_8c41d2"}'

result = client.call("kiwi-com", "get_trip", {"trip_id":"trip_8c41d2"})

const result = await cotlet.call('kiwi-com', 'get_trip', {"trip_id":"trip_8c41d2"});

cotlet call kiwi-com get_trip --data '{"trip_id":"trip_8c41d2"}'

Example response

{
  "trip_id": "512834907",
  "status": "confirmed",
  "flights": [
    {
      "flight_id": "f1",
      "route": "PRG-BCN",
      "departs": "2026-11-14T07:20:00+01:00",
      "carrier": "Example Air"
    },
    {
      "flight_id": "f2",
      "route": "BCN-PRG",
      "departs": "2026-11-17T18:45:00+01:00",
      "carrier": "Example Air"
    }
  ],
  "passengers": [
    {
      "passenger_id": "p1",
      "name": "Ana Lopez",
      "bags": [
        "Cabin bag"
      ],
      "seats": {},
      "documents_needed": [
        "document number",
        "expiry date"
      ]
    }
  ],
  "check_in": "waiting for the airline to open"
}

POST https://cotlet.dev/api/v1/kiwi-com/get_boarding_passes

Returns one download link per passenger and flight once Kiwi.com has checked you in. Before that the list is empty and check_in says what is pending. If you checked in with the airline yourself, the airline sent the pass and Kiwi.com has none.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/get_boarding_passes \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"trip_8c41d2"}'

result = client.call("kiwi-com", "get_boarding_passes", {"trip_id":"trip_8c41d2"})

const result = await cotlet.call('kiwi-com', 'get_boarding_passes', {"trip_id":"trip_8c41d2"});

cotlet call kiwi-com get_boarding_passes --data '{"trip_id":"trip_8c41d2"}'

Example response

{
  "trip_id": "512834907",
  "passes": [
    {
      "passenger_id": "p1",
      "flight_id": "f1",
      "url": "https://cotlet.dev/api/v1/files/example/boarding-pass-f1.pdf"
    },
    {
      "passenger_id": "p1",
      "flight_id": "f2",
      "url": "https://cotlet.dev/api/v1/files/example/boarding-pass-f2.pdf"
    }
  ]
}

POST https://cotlet.dev/api/v1/kiwi-com/get_baggage_options

Returns the bag options Kiwi.com offers for the itinerary, each with its price and the passenger it is for. Options are sold for the whole itinerary. The list is empty when Kiwi.com no longer sells bags for the trip, which is the case from 36 hours before departure, and for self-transfer itineraries with short layovers.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/get_baggage_options \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"trip_8c41d2"}'

result = client.call("kiwi-com", "get_baggage_options", {"trip_id":"trip_8c41d2"})

const result = await cotlet.call('kiwi-com', 'get_baggage_options', {"trip_id":"trip_8c41d2"});

cotlet call kiwi-com get_baggage_options --data '{"trip_id":"trip_8c41d2"}'

Example response

{
  "trip_id": "512834907",
  "options": [
    {
      "bag_option_id": "bo_chk20_p1",
      "passenger_id": "p1",
      "description": "Checked bag, 20 kg",
      "price": {
        "amount": 64,
        "currency": "EUR"
      }
    },
    {
      "bag_option_id": "bo_cab_p1",
      "passenger_id": "p1",
      "description": "Cabin bag, 10 kg",
      "price": {
        "amount": 38,
        "currency": "EUR"
      }
    }
  ]
}

POST https://cotlet.dev/api/v1/kiwi-com/get_seat_map

Returns the seat map Kiwi.com shows for one flight, with each free seat and its price if there is one. Seat selection is open up to 48 hours before departure. If the airline does not offer it, the list is empty and the airline assigns your seat at check-in at no extra cost.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/get_seat_map \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2"}'

result = client.call("kiwi-com", "get_seat_map", {"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2"})

const result = await cotlet.call('kiwi-com', 'get_seat_map', {"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2"});

cotlet call kiwi-com get_seat_map --data '{"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2"}'

Example response

{
  "trip_id": "512834907",
  "flight_id": "f1",
  "seats": [
    {
      "seat": "14C",
      "price": {
        "amount": 9,
        "currency": "EUR"
      }
    },
    {
      "seat": "14D",
      "price": {
        "amount": 9,
        "currency": "EUR"
      }
    }
  ]
}

POST https://cotlet.dev/api/v1/kiwi-com/get_cancellation_options

Returns the refund options Kiwi.com offers for this trip, each with a refund_option_id, where the money goes and the amount. Requests follow the rules of each airline and the ticket type: Saver and Standard tickets allow cancelling single flights, Flexi only the whole booking. The call changes nothing.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/get_cancellation_options \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"trip_8c41d2"}'

result = client.call("kiwi-com", "get_cancellation_options", {"trip_id":"trip_8c41d2"})

const result = await cotlet.call('kiwi-com', 'get_cancellation_options', {"trip_id":"trip_8c41d2"});

cotlet call kiwi-com get_cancellation_options --data '{"trip_id":"trip_8c41d2"}'

Example response

{
  "trip_id": "734120655",
  "ticket_type": "Standard",
  "options": [
    {
      "refund_option_id": "rf_credit",
      "refund_as": "Kiwi.com Credit",
      "amount": 112.5,
      "currency": "EUR"
    },
    {
      "refund_option_id": "rf_original",
      "refund_as": "Original payment",
      "amount": 98,
      "currency": "EUR"
    }
  ]
}

POST https://cotlet.dev/api/v1/kiwi-com/get_invoice

Returns the invoice Kiwi.com shows at the bottom of the booking page, as a PDF link. Billing details on it cannot be changed after booking, as Kiwi.com reports them to local tax authorities.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/get_invoice \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"trip_8c41d2"}'

result = client.call("kiwi-com", "get_invoice", {"trip_id":"trip_8c41d2"})

const result = await cotlet.call('kiwi-com', 'get_invoice', {"trip_id":"trip_8c41d2"});

cotlet call kiwi-com get_invoice --data '{"trip_id":"trip_8c41d2"}'

Example response

{
  "trip_id": "512834907",
  "invoice_url": "https://cotlet.dev/api/v1/files/example/invoice-512834907.pdf",
  "issued_on": "2026-09-02"
}

POST https://cotlet.dev/api/v1/kiwi-com/get_credit_balance

Returns the Kiwi.com Credit shown in your account, with the expiration date of each part. Credit is what Kiwi.com often issues when it refunds a cancellation.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/get_credit_balance \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("kiwi-com", "get_credit_balance")

const result = await cotlet.call('kiwi-com', 'get_credit_balance');

cotlet call kiwi-com get_credit_balance

Example response

{
  "balance": {
    "amount": 112.5,
    "currency": "EUR"
  },
  "parts": [
    {
      "amount": 112.5,
      "currency": "EUR",
      "expires_on": "2028-09-18"
    }
  ]
}

POST https://cotlet.dev/api/v1/kiwi-com/add_travel_documents

Saves the travel document details for one passenger, which Kiwi.com passes to the airline for check-in. It accepts them up to 24 hours before departure; later you check in with the airline. Send the fields get_trip lists under documents_needed. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/add_travel_documents \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"512834907","passenger_id":"p1","details":{"document_number":"XK1234567","expiry_date":"2031-04-18"}}'

result = client.call("kiwi-com", "add_travel_documents", {"trip_id":"512834907","passenger_id":"p1","details":{"document_number":"XK1234567","expiry_date":"2031-04-18"}})

const result = await cotlet.call('kiwi-com', 'add_travel_documents', {"trip_id":"512834907","passenger_id":"p1","details":{"document_number":"XK1234567","expiry_date":"2031-04-18"}});

cotlet call kiwi-com add_travel_documents --data '{"trip_id":"512834907","passenger_id":"p1","details":{"document_number":"XK1234567","expiry_date":"2031-04-18"}}'

Example response

{
  "trip_id": "512834907",
  "passenger_id": "p1",
  "status": "saved",
  "check_in": "waiting for the airline to open"
}

POST https://cotlet.dev/api/v1/kiwi-com/add_baggage

Adds one bag option to the booking and charges the price from get_baggage_options. The bag cannot be removed or moved to another passenger afterwards, and Kiwi.com may add a processing fee depending on your service package. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/add_baggage \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"512834907","bag_option_id":"bo_chk20_p1"}'

result = client.call("kiwi-com", "add_baggage", {"trip_id":"512834907","bag_option_id":"bo_chk20_p1"})

const result = await cotlet.call('kiwi-com', 'add_baggage', {"trip_id":"512834907","bag_option_id":"bo_chk20_p1"});

cotlet call kiwi-com add_baggage --data '{"trip_id":"512834907","bag_option_id":"bo_chk20_p1"}'

Example response

{
  "trip_id": "512834907",
  "status": "added",
  "bag": {
    "bag_option_id": "bo_chk20_p1",
    "description": "Checked bag, 20 kg",
    "passenger_id": "p1"
  },
  "price": {
    "amount": 64,
    "currency": "EUR"
  }
}

POST https://cotlet.dev/api/v1/kiwi-com/select_seat

Reserves one seat from get_seat_map for one passenger on one flight, up to 48 hours before departure. The seat then shows on the e-ticket and in the trip. A seat with a price charges your payment method. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/select_seat \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2","passenger_id":"passenger_8c41d2","seat":"seat"}'

result = client.call("kiwi-com", "select_seat", {"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2","passenger_id":"passenger_8c41d2","seat":"seat"})

const result = await cotlet.call('kiwi-com', 'select_seat', {"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2","passenger_id":"passenger_8c41d2","seat":"seat"});

cotlet call kiwi-com select_seat --data '{"trip_id":"trip_8c41d2","flight_id":"flight_8c41d2","passenger_id":"passenger_8c41d2","seat":"seat"}'

Example response

{
  "trip_id": "512834907",
  "flight_id": "f1",
  "passenger_id": "p1",
  "seat": "14C",
  "status": "reserved",
  "price": {
    "amount": 9,
    "currency": "EUR"
  }
}

POST https://cotlet.dev/api/v1/kiwi-com/cancel_trip

Sends the cancellation request to Kiwi.com, which handles it under the airline rules for your ticket type. Pass refund_option_id from get_cancellation_options. On Saver and Standard tickets you can name single flights in flight_ids; on Flexi tickets the whole booking is cancelled. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/kiwi-com/cancel_trip \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_id":"734120655","refund_option_id":"rf_credit"}'

result = client.call("kiwi-com", "cancel_trip", {"trip_id":"734120655","refund_option_id":"rf_credit"})

const result = await cotlet.call('kiwi-com', 'cancel_trip', {"trip_id":"734120655","refund_option_id":"rf_credit"});

cotlet call kiwi-com cancel_trip --data '{"trip_id":"734120655","refund_option_id":"rf_credit"}'

Example response

{
  "trip_id": "734120655",
  "status": "cancellation requested",
  "refund": {
    "refund_option_id": "rf_credit",
    "refund_as": "Kiwi.com Credit",
    "amount": 112.5,
    "currency": "EUR"
  }
}