{"info":{"contact":{"email":"it@reisegiganten.no","name":"Reisegiganten IT Support"},"description":"API hakuun suurimmasta ja kattavimmasta tietokannasta Suomessa pakettimatkojen tarjouksista. API:ta käytetään antamaan parhaat tarjoukset pakettimatkoista, jotka tarjoavat Tjäreborg, TUI, Apollo, Nazar, Ticket ja monet muut.","license":{"name":"MIT","url":"https:\/\/opensource.org\/licenses\/MIT"},"title":"Etsi äkkilähtöjä ja pakettimatkoja Suomesta","version":"1.0.0"},"openapi":"3.1.0","paths":{"\/services\/charter\/api_search":{"get":{"description":"Etsi parhaat saatavilla olevat pakettimatkat Suomesta hakukriteerien perusteella.","operationId":"holiday_search","parameters":[{"description":"Leveysasteikko desimaaliluvuissa, käytetään lon ja säteen kanssa","examples":{"geocode":{"summary":"Matkusta milloin tahansa hotelliin lähellä Eiffel-tornia Pariisissa","value":{"lat":48.858844,"lon":2.294351,"radius":0.8}}},"in":"query","name":"lat","required":false,"schema":{"example":27.5797,"format":"float","maximum":90,"minimum":-90,"type":"number"}},{"description":"Maksimaalinen etäisyys rannalle metreinä, esimerkiksi 0, 100, 500","in":"query","name":"distance_beach","required":false,"schema":{"type":"integer"}},{"description":"Aikaisin mahdollinen loma-ajan alkamispäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)","examples":{"gdansk":{"summary":"Etsi pakettimatkoja Gdanskiin 1. syyskuuta 2025(tarkka lähtöpäivä) - 4. syyskuuta 2025(tarkka paluupäivä)","value":{"depart_date_exact":"2025-09-01T00:00:00Z","destination_name":"Gdansk","return_date_exact":"2025-09-04T23:59:00Z"}}},"in":"query","name":"depart_date_min","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Tarjousten järjestys. Oletus on price_asc","in":"query","name":"sort","required":false,"schema":{"enum":["price_asc","price_desc","rating_asc","rating_desc","distance_beach_asc","distance_airport_asc","guest_rating_desc"],"type":"string"}},{"description":"IATA-koodi lähtöpaikalle, esimerkiksi HEL, OUL, TLL","in":"query","name":"origin_airport_code","required":false,"schema":{"type":"string"}},{"description":"Tarjottavien määrä, esimerkiksi 5, 10. Oletus 1","in":"query","name":"limit","required":false,"schema":{"example":8,"maximum":25,"minimum":1,"type":"integer"}},{"description":"Aseta true löytääksesi hotelleja suorilla lennoilla","in":"query","name":"direct_flight","required":false,"schema":{"type":"boolean"}},{"description":"Viimeisin mahdollinen loma-ajan alkamispäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)","examples":{"gdansk":{"summary":"Etsi pakettimatkoja Gdanskiin 1. syyskuuta 2025(tarkka lähtöpäivä) - 4. syyskuuta 2025(tarkka paluupäivä)","value":{"depart_date_exact":"2025-09-01T00:00:00Z","destination_name":"Gdansk","return_date_exact":"2025-09-04T23:59:00Z"}}},"in":"query","name":"depart_date_max","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Aikuisten määrä 12-99 vuotta, oletus 2","in":"query","name":"adults","required":false,"schema":{"default":2,"maximum":9,"minimum":1,"type":"integer"}},{"description":"Tarkka määrä öitä lomalle, esimerkiksi 3, 7, 14","in":"query","name":"number_of_nights","required":false,"schema":{"type":"integer"}},{"description":"Vähimmäisodotettu veden lämpötila Celsius-asteina, esimerkiksi 20, 25","in":"query","name":"temp_water","required":false,"schema":{"type":"integer"}},{"description":"Kohdenimi, esimerkiksi Malta, Magaluf, Gran Canaria","examples":{"gdansk":{"summary":"Etsi pakettimatkoja Gdanskiin 1. syyskuuta 2025(tarkka lähtöpäivä) - 4. syyskuuta 2025(tarkka paluupäivä)","value":{"depart_date_exact":"2025-09-01T00:00:00Z","destination_name":"Gdansk","return_date_exact":"2025-09-04T23:59:00Z"}}},"in":"query","name":"destination_name","required":false,"schema":{"type":"string"}},{"description":"Maantieteellinen haku rajoitettu suorakulmiolla. Muoto: minLat,minLon,maxLat,maxLon.","in":"query","name":"bbox","required":false,"schema":{"example":"28.0,-15.5,28.2,-15.3","type":"string"}},{"description":"Hotellin mukavuudet: ac=ilmastointi, adultsonly=Vain aikuisille, apartment=huoneisto, bar=baari, childspool=lastenallas, gym=kuntosali, heatedpool=lämmitetty uima-allas, kidsclub=lastenkerho, pool=uima-allas, seaview=merinäköala, restaurant=ravintola, spa=kylpylä","explode":true,"in":"query","name":"features","required":false,"schema":{"items":{"enum":["ac","adultsonly","apartment","bar","childspool","gym","heatedpool","kidsclub","pool","seaview","restaurant","spa"],"type":"string"},"type":"array"}},{"description":"Maksimaalinen etäisyys keskustaan metreinä, esimerkiksi 0, 100, 500","in":"query","name":"distance_centre","required":false,"schema":{"type":"integer"}},{"description":"Loman on alkaa tänä päivänä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)","examples":{"gdansk":{"summary":"Etsi pakettimatkoja Gdanskiin 1. syyskuuta 2025(tarkka lähtöpäivä) - 4. syyskuuta 2025(tarkka paluupäivä)","value":{"depart_date_exact":"2025-09-01T00:00:00Z","destination_name":"Gdansk","return_date_exact":"2025-09-04T23:59:00Z"}}},"in":"query","name":"depart_date_exact","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Maksimihinta koko matkalle, esimerkiksi 5000, 10000, 15000","in":"query","name":"max_price","required":false,"schema":{"type":"integer"}},{"description":"Ateriat sisältyvät hotelliin, esimerkiksi aamiainen, puolihoito, täysihoito, all inclusive","in":"query","name":"board_type","required":false,"schema":{"enum":["breakfast","half_board","full_board","all_inclusive"],"type":"string"}},{"description":"ISO-koodi maa, esimerkiksi ES, GR, PL, TR","in":"query","name":"country_iso","required":false,"schema":{"type":"string"}},{"description":"Pituusasteikko desimaaliluvuissa, käytetään lat ja säteen kanssa","examples":{"geocode":{"summary":"Matkusta milloin tahansa hotelliin lähellä Eiffel-tornia Pariisissa","value":{"lat":48.858844,"lon":2.294351,"radius":0.8}}},"in":"query","name":"lon","required":false,"schema":{"example":-15.5803,"format":"float","maximum":180,"minimum":-180,"type":"number"}},{"description":"Vähimmäismäärä päiviä lomalle, esimerkiksi 3, 7, 14","examples":{"sunbathweek":{"summary":"Etsi pakettimatkoja noin viikon kestävällä matkalla aurinkoon ja uimaan heinäkuussa 2025","value":{"category":"SUNBATH","days_max":8,"days_min":6,"depart_date_min":"2025-07-01T00:00:00Z","return_date_max":"2025-07-31T23:59:00Z"}}},"in":"query","name":"days_max","required":false,"schema":{"type":"integer"}},{"description":"Maksimimäärä päiviä lomalle, esimerkiksi 3, 7, 14","examples":{"sunbathweek":{"summary":"Etsi pakettimatkoja noin viikon kestävällä matkalla aurinkoon ja uimaan heinäkuussa 2025","value":{"category":"SUNBATH","days_max":8,"days_min":6,"depart_date_min":"2025-07-01T00:00:00Z","return_date_max":"2025-07-31T23:59:00Z"}}},"in":"query","name":"days_min","required":false,"schema":{"type":"integer"}},{"description":"Vähimmäisodotettu päivälämpötila Celsius-asteina, esimerkiksi 20, 25","in":"query","name":"temp_air_day_min","required":false,"schema":{"type":"integer"}},{"description":"Kotiinpaluupäivä alkaa tänä päivänä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)","examples":{"gdansk":{"summary":"Etsi pakettimatkoja Gdanskiin 1. syyskuuta 2025(tarkka lähtöpäivä) - 4. syyskuuta 2025(tarkka paluupäivä)","value":{"depart_date_exact":"2025-09-01T00:00:00Z","destination_name":"Gdansk","return_date_exact":"2025-09-04T23:59:00Z"}}},"in":"query","name":"return_date_exact","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Maksimaalinen etäisyys hotellin ja lentokentän välillä km, esimerkiksi 20, 40, 80","in":"query","name":"distance_airport","required":false,"schema":{"type":"integer"}},{"description":"Vähimmäisarvio, esimerkiksi 8.2, 9.0. Mediaani: 8.4","in":"query","name":"guest_rating","required":false,"schema":{"example":8.4,"format":"float","maximum":10.0,"minimum":1.0,"type":"number"}},{"description":"IATA-koodi määränpää lentokentälle, esimerkiksi ALC, AGP, TFS","in":"query","name":"destination_airport_code","required":false,"schema":{"type":"string"}},{"description":"Hotellin nimi, esimerkiksi Riu Palace, Iberostar, Sol","in":"query","name":"hotel_name","required":false,"schema":{"type":"string"}},{"description":"Viimeisin mahdollinen kotiinpaluupäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)","examples":{"gdansk":{"summary":"Etsi pakettimatkoja Gdanskiin 1. syyskuuta 2025(tarkka lähtöpäivä) - 4. syyskuuta 2025(tarkka paluupäivä)","value":{"depart_date_exact":"2025-09-01T00:00:00Z","destination_name":"Gdansk","return_date_exact":"2025-09-04T23:59:00Z"}}},"in":"query","name":"return_date_max","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Vauvojen määrä 0-1 vuotta, oletus 0","in":"query","name":"infants","required":false,"schema":{"default":0,"maximum":6,"minimum":0,"type":"integer"}},{"description":"Loman kategoria SUNBATH=Aurinko ja uiminen, CITY=Kaupunkiloma, SKI=Hiihtoloma, EXOTIC=Eksoottinen","examples":{"sunbathweek":{"summary":"Etsi pakettimatkoja noin viikon kestävällä matkalla aurinkoon ja uimaan heinäkuussa 2025","value":{"category":"SUNBATH","days_max":8,"days_min":6,"depart_date_min":"2025-07-01T00:00:00Z","return_date_max":"2025-07-31T23:59:00Z"}}},"in":"query","name":"category","required":false,"schema":{"enum":["SUNBATH","CITY","SKI","EXOTIC"],"type":"string"}},{"description":"Säde kilometreinä lat, lon","examples":{"geocode":{"summary":"Matkusta milloin tahansa hotelliin lähellä Eiffel-tornia Pariisissa","value":{"lat":48.858844,"lon":2.294351,"radius":0.8}}},"in":"query","name":"radius","required":false,"schema":{"example":1.8,"format":"float","maximum":200,"minimum":0,"type":"number"}},{"description":"Kentät, jotka on sisällytettävä hakutuloksiin","explode":true,"in":"query","name":"fields","required":false,"schema":{"default":["origin_airport_code","country_name","lat","distance_beach","destination_airport_name","lon","return_date","hotel_image","temp_water","features","destination_name","distance_centre","url","categories","number_of_nights","currency","hotel_description","departure_date","destination_airport_code","hotel_name","price_per_pers","guest_rating","distance_airport","total_price","country_code","temp_air_day","supplier_logo","origin_airport_name","features_text","room_type","supplier_name"],"example":["origin_airport_name","destination_airport_name","destination_name","hotel_name","departure_date","return_date","url","total_price"],"items":{"enum":["origin_airport_code","country_name","lat","distance_beach","destination_airport_name","lon","return_date","hotel_image","temp_water","features","destination_name","distance_centre","url","categories","number_of_nights","currency","hotel_description","departure_date","destination_airport_code","hotel_name","price_per_pers","guest_rating","distance_airport","total_price","country_code","temp_air_day","supplier_logo","origin_airport_name","features_text","room_type","supplier_name"],"type":"string"},"type":"array"}},{"description":"Maksimiodotettu päivälämpötila Celsius-asteina, esimerkiksi 25, 30","in":"query","name":"temp_air_day_max","required":false,"schema":{"type":"integer"}},{"description":"Lasten määrä 2-11 vuotta, oletus 0","in":"query","name":"children","required":false,"schema":{"default":0,"maximum":6,"minimum":0,"type":"integer"}},{"description":"Vähimmäismäärä tähtiä, esimerkiksi 3, 4, 5","in":"query","name":"rating","required":false,"schema":{"maximum":5,"minimum":1,"type":"integer"}},{"description":"Aikaisin mahdollinen kotiinpaluupäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)","examples":{"gdansk":{"summary":"Etsi pakettimatkoja Gdanskiin 1. syyskuuta 2025(tarkka lähtöpäivä) - 4. syyskuuta 2025(tarkka paluupäivä)","value":{"depart_date_exact":"2025-09-01T00:00:00Z","destination_name":"Gdansk","return_date_exact":"2025-09-04T23:59:00Z"}}},"in":"query","name":"return_date_min","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application\/json":{"schema":{"properties":{"results":{"items":{"properties":{"categories":{"description":"Kategoriat","example":["Aurinko ja uiminen","Kaupunki","Hiihto","Eksoottinen"],"items":{"type":"string"},"type":"array"},"country_code":{"description":"ISO 3166 koodi maa","example":"ES","type":"string"},"country_name":{"description":"Maan nimi","example":"Kreikka","type":"string"},"currency":{"description":"ISO 4217 valuutta","example":"EUR","type":"string"},"departure_date":{"description":"Lähtöaika ISO 8601 -muodossa YYYY-MM-DDTHH:MM:SSZ","format":"date-time","type":"string"},"destination_airport_code":{"description":"IATA-koodi määränpää lentokentälle","example":"LPA","type":"string"},"destination_airport_name":{"description":"Määränpään lentokentän nimi","example":"Gran Canaria","type":"string"},"destination_name":{"description":"Kohdenimi","example":"Playa del Ingles","type":"string"},"distance_airport":{"description":"Etäisyys lentokentältä hotelliin km","type":"integer"},"distance_beach":{"description":"Etäisyys rannalle metreinä","type":"integer"},"distance_centre":{"description":"Etäisyys keskustaan metreinä","type":"integer"},"features":{"description":"Mukavuudet","example":["pool","bar","restaurant"],"items":{"type":"string"},"type":"array"},"features_text":{"description":"Mukavuudet","example":["Uima-allas","Baari","Ravintola"],"items":{"type":"string"},"type":"array"},"guest_rating":{"description":"Keskimääräinen asiakasarvio, jossa 10.0 on paras. Vuoden 2025 varattujen hotellien mediaani on 8.4","format":"float","type":"number"},"hotel_description":{"description":"Teksti, joka kuvaa hotellia","example":"Tunne olosi kotoisaksi tässä upeassa huoneistohotellissa, jossa on 3 uima-allasta, 2 baaria ja ravintola. Ilmainen Wi-Fi ja parveke, josta on näkymä uima-altaalle.","type":"string"},"hotel_image":{"description":"URL hotellin kuvasta","type":"string"},"hotel_name":{"description":"Hotellin nimi","example":"Riu Palace","type":"string"},"lat":{"description":"Hotellin leveysasteikko desimaaliluvuissa","format":"float","type":"number"},"lon":{"description":"Hotellin pituusasteikko desimaaliluvuissa","format":"float","type":"number"},"number_of_nights":{"description":"Yöt hotellissa","type":"integer"},"origin_airport_code":{"description":"IATA-koodi määränpää lentokentälle","example":"HEL","type":"string"},"origin_airport_name":{"description":"Lähtöpaikan nimi","example":"Helsinki","type":"string"},"price_per_pers":{"description":"Hinta per henkilö, lennot ja hotelli","type":"integer"},"return_date":{"description":"Kotiinpaluun aika ISO 8601 -muodossa YYYY-MM-DDTHH:MM:SSZ","format":"date-time","type":"string"},"room_type":{"description":"Huonetyyppi ja ateriat hotellissa","example":"Kahden hengen huone, aamiainen","type":"string"},"supplier_logo":{"description":"URL järjestäjän logoon","type":"string"},"supplier_name":{"description":"Matkanjärjestäjän nimi, esimerkiksi TUI, Ving","example":"Apollo","type":"string"},"temp_air_day":{"description":"Odotettu päivälämpötila Celsius-asteina","type":"integer"},"temp_water":{"description":"Odotettu veden lämpötila Celsius-asteina","type":"integer"},"total_price":{"description":"Kokonaishinta kaikille matkustajille, lennot ja hotelli","type":"integer"},"url":{"description":"URL matkan varaamiseen","type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"Haku suoritettiin, tässä ovat parhaat saatavilla olevat pakettimatkat"},"400":{"description":"Bad request due to missing or invalid parameters."},"500":{"description":"Internal server error."}},"summary":"Search for package holiday deals"}}},"servers":[{"description":"fi API","url":"https:\/\/www.akkilahdot.fi\/services\/charter\/api_search"}]}