Journeys vs Stays

At Koala, we call Trips the booking details of the travellers.

These Trips can be of 2 different kinds: Journeys or Stays. Let see together what that means!

Definition of a Journey

Journey is the term we use to define the travellers' flights details. Inside a Journey, you will find Flights that are the combination of consecutive flights that the travellers will board.

Usually, a Journey will be composed by 1 Flight in case of a one-way trip and 2 Flights in case of a round trip.

note

In case of multi-city trip, you will need to add one Flight by stage of the traveller's journey.

Here is an example of a payload containing a round trip between Paris and Las Vegas with a connection in Seattle.

{
  "data": {
    "currency": "EUR",
    "trips": [
      {
        "price": {
          "amount": 650,
          "currency": "EUR"
        },
        "journeys": [
          {
            "flights": [
              {
                "airlineIata": "VS",
                "number": "3987",
                "departureAirportIata": "CDG",
                "arrivalAirportIata": "SEA",
                "departureDate": "2022-04-23T10:25:00.928+02:00",
                "arrivalDate": "2022-04-23T12:05:00.928-07:00"
              },
              {
                "airlineIata": "VS",
                "number": "1915",
                "departureAirportIata": "SEA",
                "arrivalAirportIata": "LAS",
                "departureDate": "2022-04-23T15:27:00.928-07:00",
                "arrivalDate": "2022-04-23T17:55:00.928-07:00"
              },
              {
                "airlineIata": "VS",
                "number": "1908",
                "departureAirportIata": "LAS",
                "arrivalAirportIata": "SEA",
                "departureDate": "2022-04-30T07:30:00.928-07:00",
                "arrivalDate": "2022-04-30T10:17:00.928-07:00"
              },
              {
                "airlineIata": "VS",
                "number": "3977",
                "departureAirportIata": "SEA",
                "arrivalAirportIata": "CDG",
                "departureDate": "2022-04-30T12:45:00.928-07:00",
                "arrivalDate": "2022-05-01T08:10:00.928+02:00"
              }
            ]
          }
        ],
        "travelers": [
          {
            "ageRange": "ADULT"
          }
        ]
      }
    ]
  }
}

Definition of Stays

Stay is the term we use to define the ground services of a booking. It can be hotel rooms, short-term rentals (campsites, etc.), experiences, etc...

A Stay is therefore a place where travellers will stay for several days.

Here is an example of a payload if you are going to a Camping called "Camping Flots Bleus":

{
  "data": {
    "currency": "EUR",
    "trips": [
      {
        "price": {
          "amount": 250,
          "currency": "EUR"
        },
        "stays": [
          {
            "address": {
              "line1": "Côte Ouest, Chem. des Blanquettes",
              "postcode": "34450",
              "countryCode": "FR",
              "locality": "Vias",
              "region": "Languedoc Roussillon"
            },
            "name": "Camping Flots Bleus",
            "startDate": "2022-04-06T10:40:00.000Z",
            "endDate": "2022-04-12T12:05:00.000Z"
          }
        ],
        "travelers": [
          {
            "ageRange": "ADULT",
            "residenceCountryCode": "FR"
          }
        ]
      }
    ]
  }
}

Trips containing both Journeys and Stays

A Trip can include both Journeys and Stays.

For instance, if you are selling packages containing both hotel and flight, you will need to send us one entry Journeys for the flights and one entry Stays for the hotel.

Here is an example of a payload if you are selling a package hotel + flight from Paris to Vegas:

{
  "data": {
    "currency": "EUR",
    "trips": [
      {
        "price": {
          "amount": 2500,
          "currency": "EUR"
        },
        "journeys": [
          {
            "flights": [
              {
                "airlineIata": "VS",
                "number": "3987",
                "departureAirportIata": "CDG",
                "arrivalAirportIata": "SEA",
                "departureDate": "2022-04-23T10:25:00.928+02:00",
                "arrivalDate": "2022-04-23T12:05:00.928-07:00"
              },
              {
                "airlineIata": "VS",
                "number": "1915",
                "departureAirportIata": "SEA",
                "arrivalAirportIata": "LAS",
                "departureDate": "2022-04-23T15:27:00.928-07:00",
                "arrivalDate": "2022-04-23T17:55:00.928-07:00"
              },
              {
                "airlineIata": "VS",
                "number": "1908",
                "departureAirportIata": "LAS",
                "arrivalAirportIata": "SEA",
                "departureDate": "2022-04-30T07:30:00.928-07:00",
                "arrivalDate": "2022-04-30T10:17:00.928-07:00"
              },
              {
                "airlineIata": "VS",
                "number": "3977",
                "departureAirportIata": "SEA",
                "arrivalAirportIata": "CDG",
                "departureDate": "2022-04-30T12:45:00.928-07:00",
                "arrivalDate": "2022-05-01T08:10:00.928+02:00"
              }
            ]
          }
        ],
        "stays": [
          {
            "address": {
              "line1": "3600 S Las Vegas Blvd",
              "postcode": "NV 89109",
              "countryCode": "US",
              "locality": "Las Vegas",
              "region": "Nevada"
            },
            "name": "Bellagio Hotel",
            "startDate": "2022-04-23T18:00:00.000Z",
            "endDate": "2022-04-30T08:00:00.000Z"
          }
        ],
        "travelers": [
          {
            "ageRange": "ADULT"
          }
        ]
      }
    ]
  }
}