API Documentation

Resource Group

Nomad API

  • endpoint: https://api.skypicker.com/traveling_salesman

  • method: POST

Nomad API

nomad_info

Please note

  • The design of this API is different from other APIs. In order to run this properly you need to run the POST request together with the payload body. The body provides the basic flights information - location, nights_range and date_range. The ‘traveling salesman’ will be renamed to ‘Nomad’.*

  • Only active parameters have been described in this document. Parameters that are not described are deprecated.

  • All URLs must be encoded (for example use %3B instead of ;)

  • The responses are G-zipped and need to be unpacked (response header Content-Encoding: gzip).

POST https://api.skypicker.com/traveling_salesman?adults=1&children=0&infants=0&v=3&curr=EUR&locale=en&lang=en&xml=0&partner=picky&partner_market=us&sort=price&asc=1&limit=1&date_from=04/08/2018&date_to=04/09/2018&return_from=30/09/2018&return_to=10/10/2018&selected_airlines=null&selected_airlines_exclude=False&fly_from=CZ&fly_to=porto&nights_on_trip_from=3&nights_on_trip_to=14&conn_on_diff_airport=1&max_stopovers=1
Requestsexample 1
Headers
Content-Type: application/json
Body
{
  "via": [
    {
      "locations": [
        "BCN"
      ],
      "nights_range": [
        3,
        5
      ]
    },
    {
      "locations": [
        "FRA"
      ],
      "nights_range": [
        3,
        5
      ]
    },
    {
      "locations": [
        "RIO"
      ],
      "nights_range": [
        3,
        5
      ]
    },
    {
      "locations": [
        "NYC"
      ],
      "nights_range": [
        3,
        5
      ]
    },
    {
      "locations": [
        "REK"
      ],
      "nights_range": [
        3,
        5
      ]
    },
    {
      "locations": [
        "CHI"
      ],
      "date_range": [
        "17/09/2018",
        "22/09/2018"
      ]
    }
  ]
}
Responses200400422
Headers
Content-Type: application/json
Body
{
  "search_params": {
    "seats": {
      "infants": 0,
      "passengers": 1,
      "adults": 1,
      "children": 0
    }
  },
  "time": 1,
  "connections": [],
  "currency": "EUR",
  "_next": "https://api.skypicker.com/flights?sort=duration&adults=1&locale=en&date_to=04%2F09%2F2018&asc=1&offset=1&partner=picky&fly_from=brno_cz&return_to=10%2F10%2F2018&flight_type=salesman&date_from=04%2F08%2F2018&fly_to=brno_cz&children=0&limit=1&return_from=30%2F09%2F2018&v=3&infants=0",
  "currency_rate": 1,
  "data": [
    {
      "deep_link": "https://www.kiwi.com/deep?from=BRQ&to=FRA&departure=04-09-2018&flightsId=3974735809836368_0%7C3974735809836368_1%7C3974735809836368_2%7C3974735809836368_3%7C3629488600055529_0%7C3810907627796485_0%7C3630587644248872_0%7C4023113167273385_0%7C3985731044980437_0%7C3985731044980437_1%7C3985731044980437_2%7C3985731044980437_3%7C3985731044980437_4%7C3940651029470107_0%7C3940651029470107_1%7C3641583224947986_0%7C3940651029470107_2%7C3940651029470107_3&price=3273.0&passengers=1&affilid=picky&lang=en&currency=EUR&booking_token=sFs2Wc2jDhgBWRq71XyP+ddXOb3oY4DD41dcsk9lWrXuvzzNl7QZ+J9nfOVv6T4hk/SeXUKafCgW6wjq3w50jugqXEOgvNFykmqBNjw7NCUIJtrUG/pamwLpYH1lCzDfQHhuHn8qyson0aDn0A3u4z85w8abpuAlBWH4D5HezvlgwGfdnYBm3fcSRGLEKzR/ac2JVAysWlX/s2TrGTIlB5hGhHAKb4pM9IKu6n0CztpvXLQRGHfHqV98Mn1YcXRbIEm9iFxquYamle2aSrNJfryCtrnZkMKUfw6jmpYLWmF0LqFLOLQTJdpGlXd5N4lrmQcqJjT8dQc7gRb6W4KePnSpys+t4rvAvDlt1hN/PG6H/avSWiotpjyFFGWQhDmnpjJZMwwTBQK+1uc5N5wbmSZ3+N6GEdzYxwmKH8JKtGvXj9uMFHL0wJix8s1SnddNZ/Wi6D/PiPwGktwS4hu5Xdqbhmjhm7n0n6NmC2ZzOckIEuBcHfXC0+UyOnmNZblq5+PM0GPSe8s87x1jd0CV/pCM2uqb0QFVe0xehI1sMcm5+3Wjh1NGER5UuzBpcwStcItbtVkB1msae61l0xRbWD9BcNKwxsagUwmjh4YRU+aR2nZbB2Qa7E5b2Ri7LXBlvYv6oLYjHbbv6GxI7Qr5GGd5q2ZrbrzpzdNR/l7eGP2HEsRwEb/I+De+tdyRWCg+gwp8M0OEqma3AX5wuL9As+9xF6LUJbTzJF+a7iBjdveJhgpRyPN07GTvummJyb9QcKlM7/kTh2dbUGekgwqoVq8WyzXYqohSi/+djFtQ9KVujP4cggxYBhs7tdRrklHu+QL2GJIQOMcYFmEShT+pma/NqVpmvJUnQl05fEQcmN0iDEyNgv11YsGX5ScxlDbx78tgHPrAQFfcVHg9VMI6auz6ywzy1a4sMH2m3Q6+MqwCYTlvEs+njzzJ/bbwGl+aIfVCM3XvGVVXOwIKUFyeaNZ945Ud2B4dHdaUz/2g19xCTJaMf8ZuDqSqHGAD/TYq2jYRSWveo3uFTzStFYTAcVy4J37zC2JHgo+uziREu73jNTPJhRsz7zlAuXQgx3RyEoz0qkzqbAIBPuRRKWGjAd0PrBKitzeYmfUkAmyzrGgGPTtzCc7vQ0/aIwS++nBFpRKNw3OgyqRZvUKS/ZShCT4faSjO/Oe0ti8HgEtSg7DHdnDuT0mDlLX+5T/DMOZ8i762uuxD8T+jsv+/UFwgfK7t3srjgLOKRBnjset4mPUs4msG/zR3/xpnM+O+QYrMTFp45wZgQxZXYSbfJaCzLE8BLqPohKp5LLNiu+z6+vd5HHefEbfNC1+cjlJ0glqPqa432Tczk3VBPC2ntd6uDd+WFvTHVUZjUfG2Z6cOtpyeCPQDsb7kMSOKkfM2FoqMixJkEqr/abvYucTf4WvXG+nrmhX2GJlJ57IEkTlzdGTAQmEMRXw1yyVUP/RkWH4b16mehkXGcSeS6WprS5zmryK17qxBCkwEzmEN7+aTjB7Nc6Rjq7GuEOu/oQGu89X0uMwnKT4EkHDGHThar6LfJdWyLjtbYSoUY56sAKC65/7vCL1Q+39kzgUUzOel4H3vVmGf047fdSGk3OZfoy6zPYaS/ynKjpwsQdCh26bPIcA=&type2=salesman",
      "price": 3273,
      "booking_token": "sFs2Wc2jDhgBWRq71XyP+ddXOb3oY4DD41dcsk9lWrXuvzzNl7QZ+J9nfOVv6T4hk/SeXUKafCgW6wjq3w50jugqXEOgvNFykmqBNjw7NCUIJtrUG/pamwLpYH1lCzDfQHhuHn8qyson0aDn0A3u4z85w8abpuAlBWH4D5HezvlgwGfdnYBm3fcSRGLEKzR/ac2JVAysWlX/s2TrGTIlB5hGhHAKb4pM9IKu6n0CztpvXLQRGHfHqV98Mn1YcXRbIEm9iFxquYamle2aSrNJfryCtrnZkMKUfw6jmpYLWmF0LqFLOLQTJdpGlXd5N4lrmQcqJjT8dQc7gRb6W4KePnSpys+t4rvAvDlt1hN/PG6H/avSWiotpjyFFGWQhDmnpjJZMwwTBQK+1uc5N5wbmSZ3+N6GEdzYxwmKH8JKtGvXj9uMFHL0wJix8s1SnddNZ/Wi6D/PiPwGktwS4hu5Xdqbhmjhm7n0n6NmC2ZzOckIEuBcHfXC0+UyOnmNZblq5+PM0GPSe8s87x1jd0CV/pCM2uqb0QFVe0xehI1sMcm5+3Wjh1NGER5UuzBpcwStcItbtVkB1msae61l0xRbWD9BcNKwxsagUwmjh4YRU+aR2nZbB2Qa7E5b2Ri7LXBlvYv6oLYjHbbv6GxI7Qr5GGd5q2ZrbrzpzdNR/l7eGP2HEsRwEb/I+De+tdyRWCg+gwp8M0OEqma3AX5wuL9As+9xF6LUJbTzJF+a7iBjdveJhgpRyPN07GTvummJyb9QcKlM7/kTh2dbUGekgwqoVq8WyzXYqohSi/+djFtQ9KVujP4cggxYBhs7tdRrklHu+QL2GJIQOMcYFmEShT+pma/NqVpmvJUnQl05fEQcmN0iDEyNgv11YsGX5ScxlDbx78tgHPrAQFfcVHg9VMI6auz6ywzy1a4sMH2m3Q6+MqwCYTlvEs+njzzJ/bbwGl+aIfVCM3XvGVVXOwIKUFyeaNZ945Ud2B4dHdaUz/2g19xCTJaMf8ZuDqSqHGAD/TYq2jYRSWveo3uFTzStFYTAcVy4J37zC2JHgo+uziREu73jNTPJhRsz7zlAuXQgx3RyEoz0qkzqbAIBPuRRKWGjAd0PrBKitzeYmfUkAmyzrGgGPTtzCc7vQ0/aIwS++nBFpRKNw3OgyqRZvUKS/ZShCT4faSjO/Oe0ti8HgEtSg7DHdnDuT0mDlLX+5T/DMOZ8i762uuxD8T+jsv+/UFwgfK7t3srjgLOKRBnjset4mPUs4msG/zR3/xpnM+O+QYrMTFp45wZgQxZXYSbfJaCzLE8BLqPohKp5LLNiu+z6+vd5HHefEbfNC1+cjlJ0glqPqa432Tczk3VBPC2ntd6uDd+WFvTHVUZjUfG2Z6cOtpyeCPQDsb7kMSOKkfM2FoqMixJkEqr/abvYucTf4WvXG+nrmhX2GJlJ57IEkTlzdGTAQmEMRXw1yyVUP/RkWH4b16mehkXGcSeS6WprS5zmryK17qxBCkwEzmEN7+aTjB7Nc6Rjq7GuEOu/oQGu89X0uMwnKT4EkHDGHThar6LfJdWyLjtbYSoUY56sAKC65/7vCL1Q+39kzgUUzOel4H3vVmGf047fdSGk3OZfoy6zPYaS/ynKjpwsQdCh26bPIcA=",
      "currency": "EUR",
      "facilitated_booking_available": false,
      "bags_price": {
        "1": 312
      },
      "route": [
        {
          "flyTo": "FRA",
          "mapIdto": "frankfurt_de",
          "airlines": [
            "LH"
          ],
          "pnr_count": 1,
          "fly_duration": "3h 0m",
          "has_airport_change": false,
          "distance": 594.05,
          "type_flights": [
            "GDS"
          ],
          "flyFrom": "BRQ",
          "dTimeUTC": 1536080400,
          "dTime": 1536087600,
          "cityFrom": "Brno",
          "mapIdfrom": "brno_cz",
          "id": "3974735809836368_0|3974735809836368_1|3974735809836368_2|3974735809836368_3",
          "countryTo": {
            "code": "DE",
            "name": "Germany"
          },
          "aTimeUTC": 1536091200,
          "cityTo": "Frankfurt",
          "transfers": [],
          "aTime": 1536098400,
          "route": [
            {
              "aTimeUTC": 1536084300,
              "refresh_timestamp": 1535438404,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 48.353889,
              "flight_no": 5290,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "BM",
              "fare_basis": "S13CLSE3",
              "cityTo": "Munich",
              "mapIdfrom": "brno_cz",
              "lngFrom": 16.694444,
              "vehicle_type": "aircraft",
              "flyFrom": "BRQ",
              "id": "3974735809836368_0",
              "dTimeUTC": 1536080400,
              "equipment": "ER4",
              "mapIdto": "munich_de",
              "combination_id": "3974735809836368",
              "dTime": 1536087600,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "MUC",
              "source": "deprecated",
              "latFrom": 49.151389,
              "airline": "LH",
              "fare_classes": "S",
              "lngTo": 11.786111,
              "cityFrom": "Brno",
              "aTime": 1536091500,
              "guarantee": false,
              "last_seen": 1535438404
            },
            {
              "aTimeUTC": 1536091200,
              "refresh_timestamp": 1535438404,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 50.033056,
              "flight_no": 123,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "LH",
              "fare_basis": "S13CLSE3",
              "cityTo": "Frankfurt",
              "mapIdfrom": "munich_de",
              "lngFrom": 11.786111,
              "vehicle_type": "aircraft",
              "flyFrom": "MUC",
              "id": "3974735809836368_1",
              "dTimeUTC": 1536087600,
              "equipment": "321",
              "mapIdto": "frankfurt_de",
              "combination_id": "3974735809836368",
              "dTime": 1536094800,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "FRA",
              "source": "deprecated",
              "latFrom": 48.353889,
              "airline": "LH",
              "fare_classes": "S",
              "lngTo": 8.570556,
              "cityFrom": "Munich",
              "aTime": 1536098400,
              "guarantee": false,
              "last_seen": 1535438404
            }
          ],
          "countryFrom": {
            "code": "CZ",
            "name": "Czechia"
          }
        },
        {
          "flyTo": "BCN",
          "mapIdto": "barcelona_es",
          "airlines": [
            "FR"
          ],
          "pnr_count": 1,
          "fly_duration": "1h 55m",
          "has_airport_change": false,
          "distance": 1094.81,
          "type_flights": [
            "lcc-FR"
          ],
          "flyFrom": "FRA",
          "dTimeUTC": 1536417000,
          "dTime": 1536424200,
          "cityFrom": "Frankfurt",
          "mapIdfrom": "frankfurt_de",
          "id": "3629488600055529_0",
          "countryTo": {
            "code": "ES",
            "name": "Spain"
          },
          "aTimeUTC": 1536423900,
          "cityTo": "Barcelona",
          "transfers": [],
          "aTime": 1536431100,
          "route": [
            {
              "aTimeUTC": 1536423900,
              "refresh_timestamp": 1535520742,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 41.296944,
              "flight_no": 1680,
              "price": 1,
              "original_return": 0,
              "operating_carrier": null,
              "fare_basis": "VLDISZP",
              "cityTo": "Barcelona",
              "mapIdfrom": "frankfurt_de",
              "lngFrom": 8.570556,
              "vehicle_type": "aircraft",
              "flyFrom": "FRA",
              "id": "3629488600055529_0",
              "dTimeUTC": 1536417000,
              "equipment": null,
              "mapIdto": "barcelona_es",
              "combination_id": "3629488600055529",
              "dTime": 1536424200,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "BCN",
              "source": "deprecated",
              "latFrom": 50.033056,
              "airline": "FR",
              "fare_classes": "V",
              "lngTo": 2.078333,
              "cityFrom": "Frankfurt",
              "aTime": 1536431100,
              "guarantee": false,
              "last_seen": 1535520741
            }
          ],
          "countryFrom": {
            "code": "DE",
            "name": "Germany"
          }
        },
        {
          "flyTo": "KEF",
          "mapIdto": "reykjavik_is",
          "airlines": [
            "D8"
          ],
          "pnr_count": 1,
          "fly_duration": "4h 30m",
          "has_airport_change": false,
          "distance": 2984.39,
          "type_flights": [
            "lcc-DY"
          ],
          "flyFrom": "BCN",
          "dTimeUTC": 1536845400,
          "dTime": 1536852600,
          "cityFrom": "Barcelona",
          "mapIdfrom": "barcelona_es",
          "id": "3810907627796485_0",
          "countryTo": {
            "code": "IS",
            "name": "Iceland"
          },
          "aTimeUTC": 1536861600,
          "cityTo": "Reykjavik",
          "transfers": [],
          "aTime": 1536861600,
          "route": [
            {
              "aTimeUTC": 1536861600,
              "refresh_timestamp": 1535508123,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 63.985,
              "flight_no": 5666,
              "price": 1,
              "original_return": 0,
              "operating_carrier": null,
              "fare_basis": "",
              "cityTo": "Reykjavik",
              "mapIdfrom": "barcelona_es",
              "lngFrom": 2.078333,
              "vehicle_type": "aircraft",
              "flyFrom": "BCN",
              "id": "3810907627796485_0",
              "dTimeUTC": 1536845400,
              "equipment": null,
              "mapIdto": "reykjavik_is",
              "combination_id": "3810907627796485",
              "dTime": 1536852600,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "KEF",
              "source": "deprecated",
              "latFrom": 41.296944,
              "airline": "D8",
              "fare_classes": "",
              "lngTo": -22.605556,
              "cityFrom": "Barcelona",
              "aTime": 1536861600,
              "guarantee": false,
              "last_seen": 1535508123
            }
          ],
          "countryFrom": {
            "code": "ES",
            "name": "Spain"
          }
        },
        {
          "flyTo": "ORD",
          "mapIdto": "chicago_il_us",
          "airlines": [
            "FI"
          ],
          "pnr_count": 1,
          "fly_duration": "6h 30m",
          "has_airport_change": false,
          "distance": 4730.41,
          "type_flights": [
            "lcc-FI"
          ],
          "flyFrom": "KEF",
          "dTimeUTC": 1537202700,
          "dTime": 1537202700,
          "cityFrom": "Reykjavik",
          "mapIdfrom": "reykjavik_is",
          "id": "3630587644248872_0",
          "countryTo": {
            "code": "US",
            "name": "United States"
          },
          "aTimeUTC": 1537226100,
          "cityTo": "Chicago",
          "transfers": [],
          "aTime": 1537208100,
          "route": [
            {
              "aTimeUTC": 1537226100,
              "refresh_timestamp": 1535517952,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 41.978611,
              "flight_no": 853,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "FI",
              "fare_basis": "",
              "cityTo": "Chicago",
              "mapIdfrom": "reykjavik_is",
              "lngFrom": -22.605556,
              "vehicle_type": "aircraft",
              "flyFrom": "KEF",
              "id": "3630587644248872_0",
              "dTimeUTC": 1537202700,
              "equipment": "75W",
              "mapIdto": "chicago_il_us",
              "combination_id": "3630587644248872",
              "dTime": 1537202700,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "ORD",
              "source": "deprecated",
              "latFrom": 63.985,
              "airline": "FI",
              "fare_classes": "",
              "lngTo": -87.904722,
              "cityFrom": "Reykjavik",
              "aTime": 1537208100,
              "guarantee": false,
              "last_seen": 1535509770
            }
          ],
          "countryFrom": {
            "code": "IS",
            "name": "Iceland"
          }
        },
        {
          "flyTo": "LGA",
          "mapIdto": "new-york-city_ny_us",
          "airlines": [
            "UA"
          ],
          "pnr_count": 1,
          "fly_duration": "2h 6m",
          "has_airport_change": false,
          "distance": 1178.35,
          "type_flights": [
            "lcc-UA"
          ],
          "flyFrom": "ORD",
          "dTimeUTC": 1537621200,
          "dTime": 1537603200,
          "cityFrom": "Chicago",
          "mapIdfrom": "chicago_il_us",
          "id": "4023113167273385_0",
          "countryTo": {
            "code": "US",
            "name": "United States"
          },
          "aTimeUTC": 1537628760,
          "cityTo": "New York City",
          "transfers": [],
          "aTime": 1537614360,
          "route": [
            {
              "aTimeUTC": 1537628760,
              "refresh_timestamp": 1535518715,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 40.777222,
              "flight_no": 1166,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "UA",
              "fare_basis": "",
              "cityTo": "New York City",
              "mapIdfrom": "chicago_il_us",
              "lngFrom": -87.904722,
              "vehicle_type": "aircraft",
              "flyFrom": "ORD",
              "id": "4023113167273385_0",
              "dTimeUTC": 1537621200,
              "equipment": "319",
              "mapIdto": "new-york-city_ny_us",
              "combination_id": "4023113167273385",
              "dTime": 1537603200,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "LGA",
              "source": "deprecated",
              "latFrom": 41.978611,
              "airline": "UA",
              "fare_classes": "",
              "lngTo": -73.8725,
              "cityFrom": "Chicago",
              "aTime": 1537614360,
              "guarantee": false,
              "last_seen": 1535518715
            }
          ],
          "countryFrom": {
            "code": "US",
            "name": "United States"
          }
        },
        {
          "flyTo": "GIG",
          "mapIdto": "rio-de-janeiro_rj_br",
          "airlines": [
            "O6"
          ],
          "pnr_count": 1,
          "fly_duration": "12h 45m",
          "has_airport_change": false,
          "distance": 7738.16,
          "type_flights": [
            "GDS"
          ],
          "flyFrom": "JFK",
          "dTimeUTC": 1538019000,
          "dTime": 1538004600,
          "cityFrom": "New York City",
          "mapIdfrom": "new-york-city_ny_us",
          "id": "3985731044980437_0|3985731044980437_1|3985731044980437_2|3985731044980437_3|3985731044980437_4",
          "countryTo": {
            "code": "BR",
            "name": "Brazil"
          },
          "aTimeUTC": 1538064900,
          "cityTo": "Rio de Janeiro",
          "transfers": [],
          "aTime": 1538054100,
          "route": [
            {
              "aTimeUTC": 1538054700,
              "refresh_timestamp": 1535360539,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": -23.431944,
              "flight_no": 8501,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "O6",
              "fare_basis": "ZLV28JIA",
              "cityTo": "São Paulo",
              "mapIdfrom": "new-york-city_ny_us",
              "lngFrom": -73.778889,
              "vehicle_type": "aircraft",
              "flyFrom": "JFK",
              "id": "3985731044980437_0",
              "dTimeUTC": 1538019000,
              "equipment": "332",
              "mapIdto": "sao-paulo_sp_br",
              "combination_id": "3985731044980437",
              "dTime": 1538004600,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "GRU",
              "source": "deprecated",
              "latFrom": 40.639722,
              "airline": "O6",
              "fare_classes": "Z",
              "lngTo": -46.469444,
              "cityFrom": "New York City",
              "aTime": 1538043900,
              "guarantee": false,
              "last_seen": 1535360539
            },
            {
              "aTimeUTC": 1538064900,
              "refresh_timestamp": 1535360539,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": -22.8125,
              "flight_no": 6252,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "O6",
              "fare_basis": "ZLV28JIA",
              "cityTo": "Rio de Janeiro",
              "mapIdfrom": "sao-paulo_sp_br",
              "lngFrom": -46.469444,
              "vehicle_type": "aircraft",
              "flyFrom": "GRU",
              "id": "3985731044980437_1",
              "dTimeUTC": 1538060700,
              "equipment": "320",
              "mapIdto": "rio-de-janeiro_rj_br",
              "combination_id": "3985731044980437",
              "dTime": 1538049900,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "GIG",
              "source": "deprecated",
              "latFrom": -23.431944,
              "airline": "O6",
              "fare_classes": "V",
              "lngTo": -43.248333,
              "cityFrom": "São Paulo",
              "aTime": 1538054100,
              "guarantee": false,
              "last_seen": 1535360539
            }
          ],
          "countryFrom": {
            "code": "US",
            "name": "United States"
          }
        },
        {
          "flyTo": "BRQ",
          "mapIdto": "brno_cz",
          "airlines": [
            "BM",
            "LX"
          ],
          "pnr_count": 2,
          "fly_duration": "16h 45m",
          "has_airport_change": false,
          "distance": 9963.13,
          "type_flights": [
            "GDS",
            "lcc-BM"
          ],
          "flyFrom": "GIG",
          "dTimeUTC": 1538414100,
          "dTime": 1538403300,
          "cityFrom": "Rio de Janeiro",
          "mapIdfrom": "rio-de-janeiro_rj_br",
          "id": "3940651029470107_0|3940651029470107_1|3641583224947986_0|3940651029470107_2|3940651029470107_3",
          "countryTo": {
            "code": "CZ",
            "name": "Czechia"
          },
          "aTimeUTC": 1538474400,
          "cityTo": "Brno",
          "transfers": [],
          "aTime": 1538481600,
          "route": [
            {
              "aTimeUTC": 1538454600,
              "refresh_timestamp": 1535360769,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 47.464722,
              "flight_no": 8097,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "WK",
              "fare_basis": "TRCBR",
              "cityTo": "Zürich",
              "mapIdfrom": "rio-de-janeiro_rj_br",
              "lngFrom": -43.248333,
              "vehicle_type": "aircraft",
              "flyFrom": "GIG",
              "id": "3940651029470107_0",
              "dTimeUTC": 1538414100,
              "equipment": "343",
              "mapIdto": "zurich_ch",
              "combination_id": "3940651029470107",
              "dTime": 1538403300,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "ZRH",
              "source": "deprecated",
              "latFrom": -22.8125,
              "airline": "LX",
              "fare_classes": "T",
              "lngTo": 8.549167,
              "cityFrom": "Rio de Janeiro",
              "aTime": 1538461800,
              "guarantee": false,
              "last_seen": 1535360769
            },
            {
              "aTimeUTC": 1538460900,
              "refresh_timestamp": 1535360769,
              "bags_recheck_required": false,
              "return": 0,
              "latTo": 48.353889,
              "flight_no": 1100,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "LX",
              "fare_basis": "TRCBR",
              "cityTo": "Munich",
              "mapIdfrom": "zurich_ch",
              "lngFrom": 8.549167,
              "vehicle_type": "aircraft",
              "flyFrom": "ZRH",
              "id": "3940651029470107_1",
              "dTimeUTC": 1538457300,
              "equipment": "CS1",
              "mapIdto": "munich_de",
              "combination_id": "3940651029470107",
              "dTime": 1538464500,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "MUC",
              "source": "deprecated",
              "latFrom": 47.464722,
              "airline": "LX",
              "fare_classes": "T",
              "lngTo": 11.786111,
              "cityFrom": "Zürich",
              "aTime": 1538468100,
              "guarantee": false,
              "last_seen": 1535360769
            },
            {
              "aTimeUTC": 1538474400,
              "refresh_timestamp": 1535514425,
              "bags_recheck_required": true,
              "return": 0,
              "latTo": 49.151389,
              "flight_no": 1733,
              "price": 1,
              "original_return": 0,
              "operating_carrier": "BM",
              "fare_basis": "",
              "cityTo": "Brno",
              "mapIdfrom": "munich_de",
              "lngFrom": 11.786111,
              "vehicle_type": "aircraft",
              "flyFrom": "MUC",
              "id": "3641583224947986_0",
              "dTimeUTC": 1538470500,
              "equipment": "ER3",
              "mapIdto": "brno_cz",
              "combination_id": "3641583224947986",
              "dTime": 1538477700,
              "fare_family": "",
              "found_on": "deprecated",
              "flyTo": "BRQ",
              "source": "deprecated",
              "latFrom": 48.353889,
              "airline": "BM",
              "fare_classes": "",
              "lngTo": 16.694444,
              "cityFrom": "Munich",
              "aTime": 1538481600,
              "guarantee": true,
              "last_seen": 1535468178
            }
          ],
          "countryFrom": {
            "code": "BR",
            "name": "Brazil"
          }
        }
      ],
      "baglimit": {
        "hand_width": null,
        "hand_length": null,
        "hold_weight": null,
        "hand_height": null,
        "hand_weight": null
      }
    }
  ],
  "_prev": null,
  "ref_tasks": [],
  "refresh": [],
  "del": null,
  "_results": 6,
  "search_id": "200aa6a9-757d-439b-a187-31cd3242e010"
}
Headers
Content-Type: application/json
Body
{
  "message": "Here you will be notified of the error that occurred."
}
Headers
Content-Type: application/json
Body
{
  "message": [
    {
      "errors": [
        "Not recognized location: `XXX`"
      ],
      "param": "fly_to"
    }
  ]
}

Nomad API
POST/traveling_salesman{?adults,children,infants,v,curr,locale,lang,xml,partner,partner_market,sort,asc,limit,date_from,date_to,return_from,return_to,selected_airlines,selected_airlines_exclude,fly_from,fly_to,nights_on_trip_from,nights_on_trip_to,conn_on_diff_airport,max_stopovers}

Each VIA in the payload of the request consists of three body parameters that are used in this API:

locations - BCN (required, list) - Kiwi api ID of the departure destination. Accepts multiple values separated by comma, these values might be airport codes, city IDs, two letter country codes, metropolitan codes and radiuses.

Radius needs to be in form lat-lon-xkm. E.g.-23.24--47.86-500km for places around Sao Paulo. ‘LON’ - checks every airport in London, ‘LHR’ - checks flights from London Heathrow, ‘UK’ - flights from the United Kingdom. The number of decimal places is limited to 6. Link to Locations API.

nights_range - [3,5] (optional, string) - number of nights [from,to]. Min is 1 and max is 30 nights.

date_range - ["27/08/2018","02/09/2018"] (optional, string) - date range of the stay

Please note, that either the nights_range or date_range parameters must be populated. If only the date_range is used, the from and to dates are applied. In those cases where both the nights_range and the date_range are populated, then the nights_range works as time windows between date_from and date_to.

URI Parameters
HideShow
adults
integer (optional) Example: 1

Used to specify the number of adults. Please note, that children are considered adults in our search engine. The default adults value is 1. The sum of adults, children and infants cannot be greater than 9. Previous name: passengers

children
integer (optional) Example: 0

It is used to specify the number of children. The default value is 0. At the moment, children are considered adults in our search engine. We are working on improvements. The sum of adults, children and infants cannot be greater than 9.

infants
integer (optional) Example: 0

It is used to specify number of infants. The default value is 0. The sum of adults, children and infants cannot be greater than 9. // + price_from: 1 (optional, integer) - result filter, minimal price // + price_to: 10000 (optional, integer) - result filter, maximal price

v
integer (required) Example: 3

api version of locations. Please, use 3 at all times. Default value ‘v=3’.

curr
string (optional) Example: EUR

use this parameter to change the currency in the response

Choices: AED AFN ALL AMD ANG AOA ARS AUD AWG AZN BAM BBD BDT BGN BHD BIF BMD BND BOB BRL BSD BTC BTN BWP BYR BZD CAD CDF CHF CLF CLP CNY COP CRC CUC CUP CVE CZK DJF DKK DOP DZD EEK EGP ERN ETB EUR FJD FKP GBP GEL GGP GHS GIP GMD GNF GTQ GYD HKD HNL HRK HTG HUF IDR ILS IMP INR IQD IRR ISK JEP JMD JOD JPY KES KGS KHR KMF KPW KRW KWD KYD KZT LAK LBP LKR LRD LSL LTL LVL LYD MAD MDL MGA MKD MMK MNT MOP MRO MTL MUR MVR MWK MXN MYR MZN NAD NGN NIO NOK NPR NZD OMR PAB PEN PGK PHP PKR PLN PYG QAR QUN RON RSD RUB RWF SAR SBD SCR SDG SEK SGD SHP SLL SOS SRD STD SVC SYP SZL THB TJS TMT TND TOP TRY TTD TWD TZS UAH UGX USD UYU UZS VEF VND VUV WST XAF XAG XAU XCD XDR XOF XPD XPF XPT YER ZAR ZMK ZMW ZWL

locale
string (optional) Example: en

the language of city names in the response and also language of kiwi.com website to which deep_link leads, market, region and currency.

Choices: ae ag ar at au be bg bh br by ca ca-fr ch cl cn co ct cz da de dk ec ee el en es fi fr gb gr hk hr hu id ie il in is it ja jo jp ko kr kw kz lt mx my nl no nz om pe ph pl pt qa ro rs ru sa se sg sk sr sv th tr tw ua uk us vn za

lang
string (optional) Example: en

language - if language is added to locale, then everything remains the same, only the language changes.

xml
integer (optional) Example: 0

returns an xml response instead of json

partner
string (required) Example: picky

partner ID. If present, the result will include a link to a specific trip directly to Kiwi.com, with the affiliate ID included (use picky partner ID for testing)

partner_market
string (optional) Example: us

market from which the request is coming

sort
string (optional) Example: price

sorts the results by quality, price, date or duration. Quality is the default value

asc
integer (optional) Example: 1

can be set to 1 or 0, default is 1 - from cheapest flights to the most expensive

limit
integer (optional) Example: 1

limit the number of results, max is 200

date_from
string (required) Example: 04/08/2018

search flights from this date (DD/MM/YYYY). Use parameters date_from and date_to as a date range for the flight departure. Parameters ‘date_from=01/05/2016’ and ‘date_to=30/05/2016’ mean that the departure can be anytime between the specified dates. For the dates of the return flights, use the ‘return_to’ and ‘return_from’ or ‘nights_on_trip_from’ and ‘nights_on_trip_to’ parameters.

date_to
string (required) Example: 04/09/2018

search flights upto this date (DD/MM/YYYY)

return_from
string (required) Example: 30/09/2018

search flights from this date (DD/MM/YYYY). Use parameters dateFrom and dateTo as a date range for the flight departure. Parameters ‘date_from=01/05/2016’ and ‘date_to=30/05/2016’ mean that the departure can be anytime between the specified dates. For the dates of the return flights, use the ‘return_to’ and ‘return_from’ or ‘nights_on_trip_from’ and ‘nights_on_trip_to’ parameters.

return_to
string (required) Example: 10/10/2018

search flights upto this date (DD/MM/YYYY)

selected_airlines
string (optional) Example: null

a list of airlines (IATA codes) separated by ‘,’ (commas) that should / should not be included in the search. The selection or omission of the airline depends on the ‘selected_airlines_exclude’ parameter. Select a list of airlines and use the ‘selected_airlines_exclude’ parameter to specify whether or not the selected airlines should be excluded/included in the search.

selected_airlines_exclude
boolean (optional) Example: False

it can be thought of as a switch for the ‘selected_airlines’ parameter where ‘False=select’ and ‘True=omit’. If set to true the search returns combinations without the airlines specified in the parent parameter selected_airlines. If set to false the search returns combinations where none of the flights in this combinations is served by any given airline code.

fly_from
string (required) Example: CZ

Kiwi api ID of the departure location.

It accepts multiple values separated by comma, these values might be airport codes, city IDs, two letter country codes, metropolitan codes and radiuses as well as subdivision, region, autonomous_territory, continent and specials (Points of interest, such as Times Square).

Some locations have the same code for airport and metropolis (city), e.g. DUS stands for metro code Duesseldorf, Moenchengladbach and Weeze as well as Duesseldorf airport. See the following examples:

  • fly_from=city:DUS will match all airports in “DUS”, “MGL” and “NRN” (all in the city of Duesseldorf)

  • fly_from=DUS will do the same as the above

  • fly_from=airport:DUS will only match airport “DUS” Radius needs to be in form lat-lon-xkm. The number of decimal places for radius is limited to 6. E.g.-23.24--47.86-500km for places around Sao Paulo. ‘LON’ - checks every airport in London, ‘LHR’ - checks flights from London Heathrow, ‘UK’ - flights from the United Kingdom. Link to Locations API. Previous name: flyFrom

fly_to
string (required) Example: porto

Kiwi api ID of the arrival destination. It accepts the same values in the same format as the fly_from parameter. Previous name: to.

If you don’t include any value you’ll get results for all airports in the world.

nights_on_trip_from
integer (optional) Example: 3

the minimal length of stay in the destination. Counts nights, not days.

nights_on_trip_to
integer (optional) Example: 14

the max length of stay in the destination (use only one from the nights_on_trip_from / nights_on_trip_to and return_from / return_to parameters. If both of them are given, the API uses the nights_on_trip parameters and the return dates are ignored). When you omit one of these two params, the default value for nights_on_trip_from is 1 and for nights_on_trip_to is 14.

conn_on_diff_airport
integer (optional) Example: 1

whether or not to search for connections on different airport, can be set to 0 or 1; 1 is default

max_stopovers
integer (optional) Example: 1

global filter - maximum stopover count for each flight


Generated by aglio on 13 Aug 2019