Method creates and returns an access token that needs to be used to make authorized API calls.
To make an authorized API call add Authorization: Bearer <token> header to your request.

ⓘ Access token is valid for one day (24 hours) after creation.

EXAMPLE INPUT

{
  "api_key": "your_api_key",
  "api_secret": "your_api_secret"
}

EXAMPLE OUTPUT

{
  "token": "your_access_token",
  "created_at": 1735261799,
  "expires_at": 1735348199
}

Method returns all transfer destination names mapped by corresponding destination codes.

Destination codes must be used for fields route_from_code, route_to_code and return_route_to_code when creating a transfer request.

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "airport-15": "Annecy Meythet Airport",
  "airport-22": "Basel Airport",
  "airport-38": "Bergamo airport (Milan Orio)",
  "airport-3": "Chambery Airport",
  ...
  "resort-264": "Zillertal",
  "resort-435": "Zinal",
  "resort-204": "Zug, CH",
  "resort-200": "Zuoz",
  ...
}

All prices are returned in EUR.

If the requested transfer is invalid or not available for booking, the response will contain a single parameter - error.

Transfer attributes:

All AdditionalInformation attributes are optional and have no default value:

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

MINIMAL ONE-WAY EXAMPLE INPUT

{
  "Transfer": {
    "is_return": 0,
    "route_from_code": "airport-1",
    "route_to_code": "resort-22",
    "outbound_date": "2023-12-23",
    "outbound_time_hours": 11,
    "outbound_time_minutes": 5,
    "adult_count": 2
  },
  "AdditionalInformation": []
}

MINIMAL ROUND-TRIP EXAMPLE INPUT

{
  "Transfer": {
    "route_from_code": "airport-1",
    "route_to_code": "resort-22",
    "outbound_date": "2023-12-23",
    "outbound_time_hours": 11,
    "outbound_time_minutes": 5,
    "return_date": "2024-01-05",
    "return_time_hours": 21,
    "return_time_minutes": 0,
    "adult_count": 2,
    "return_adult_count": 2
  },
  "AdditionalInformation": []
}

Full Example

EXAMPLE INPUT

{
  "Transfer": {
    "is_return": 1,
    "route_from_code": "airport-1",
    "route_to_code": "resort-22",
    "return_route_to_code": "airport-3",
    "outbound_date": "2023-12-23",
    "outbound_time_hours": 11,
    "outbound_time_minutes": 5,
    "outbound_selected_time_is_flight": 1,
    "return_date": "2024-01-05",
    "return_time_hours": 21,
    "return_time_minutes": 0,
    "return_selected_time_is_flight": 1,
    "adult_count": 2,
    "children_count": 1,
    "return_adult_count": 2,
    "return_children_count": 1
  },
  "AdditionalInformation": {
    "booster_seat_count": 1,
    "child_seat_count": 0,
    "ski_count": 1,
    "snowboard_count": 0,
    "return_booster_seat_count": 1,
    "return_child_seat_count": 0,
    "return_ski_count": 1,
    "return_snowboard_count": 1,
    "accommodation_name": "Hotel Name",
    "accommodation_address": "Hotel Address",
    "accommodation_coordinates": "46.341883, 11.539972",
    "flight_number": "FL123",
    "return_flight_number": "FL321",
    "additional_information": ""
  }
}

EXAMPLE OUTPUT

{
  "Transfer": {
    "id": 123456,
    "type": "private",
    "discount_applied": 1,
    "TransferSelection": {
      "outbound": {
        "from": "Geneva Airport",
        "to": "Auris en Oisans Grandes Rousses",
        "flight_date_time": "2023-12-23 11:05:00",
        "selected_time_is_flight": 1,
        "offers": {
          "requested-2": {
            "pick_up_date_time": "2023-12-23 11:05:00",
            "price": 601.8,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 14:55:00",
            "waiting_time": "",
            "vehicle_type_id": 2
          },
          "off_peak-0-2": {
            "pick_up_date_time": "2023-12-23 14:00:00",
            "price": 559.3,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 17:50:00",
            "waiting_time": "02:55:00",
            "vehicle_type_id": 2
          },
          "off_peak-1-2": {
            "pick_up_date_time": "2023-12-23 13:00:00",
            "price": 529,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 16:50:00",
            "waiting_time": "03:55:00",
            "vehicle_type_id": 2
          },
          ...
          "requested-4": {
            "pick_up_date_time": "2023-12-23 11:05:00",
            "price": 1054,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 14:55:00",
            "waiting_time": "",
            "vehicle_type_id": 4
          }
        }
      },
      "return": {
        "from": "Auris en Oisans Grandes Rousses",
        "to": "Chambery Airport",
        "flight_date_time": "2024-01-05 21:00:00",
        "selected_time_is_flight": 1,
        "check_in_date_time": "2024-01-05 19:00:00",
        "offers": {
          "requested-2": {
            "pick_up_date_time": "2024-01-05 16:50:00",
            "price": 238.85,
            "travel_time": "02:10:00",
            "arrival_date_time": "2024-01-05 19:00:00",
            "waiting_time": "",
            "vehicle_type_id": 2
          },
          ...
          "requested-4": {
            "pick_up_date_time": "2024-01-05 16:50:00",
            "price": 534.65,
            "travel_time": "02:10:00",
            "arrival_date_time": "2024-01-05 19:00:00",
            "waiting_time": "",
            "vehicle_type_id": 4
          }
        }
      }
    }
  }
}

Note that transfer request offers expire 24 hours after creation.

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "Transfer": {
    "id": 123456,
    "type": "private",
    "discount_applied": 1,
    "TransferSelection": {
      "outbound": {
        "from": "Geneva Airport",
        "to": "Auris en Oisans Grandes Rousses",
        "flight_date_time": "2023-12-23 11:05:00",
        "selected_time_is_flight": 1,
        "offers": {
          "requested-2": {
            "pick_up_date_time": "2023-12-23 11:05:00",
            "price": 601.8,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 14:55:00",
            "waiting_time": "",
            "vehicle_type_id": 2
          },
          "off_peak-0-2": {
            "pick_up_date_time": "2023-12-23 14:00:00",
            "price": 559.3,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 17:50:00",
            "waiting_time": "02:55:00",
            "vehicle_type_id": 2
          },
          "off_peak-1-2": {
            "pick_up_date_time": "2023-12-23 13:00:00",
            "price": 529,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 16:50:00",
            "waiting_time": "03:55:00",
            "vehicle_type_id": 2
          },
          ...
          "requested-4": {
            "pick_up_date_time": "2023-12-23 11:05:00",
            "price": 1054,
            "travel_time": "03:50:00",
            "arrival_date_time": "2023-12-23 14:55:00",
            "waiting_time": "",
            "vehicle_type_id": 4
          }
        }
      },
      "return": {
        "from": "Auris en Oisans Grandes Rousses",
        "to": "Chambery Airport",
        "flight_date_time": "2024-01-05 21:00:00",
        "selected_time_is_flight": 1,
        "check_in_date_time": "2024-01-05 19:00:00",
        "offers": {
          "requested-2": {
            "pick_up_date_time": "2024-01-05 16:50:00",
            "price": 238.85,
            "travel_time": "02:10:00",
            "arrival_date_time": "2024-01-05 19:00:00",
            "waiting_time": "",
            "vehicle_type_id": 2
          },
          ...
          "requested-4": {
            "pick_up_date_time": "2024-01-05 16:50:00",
            "price": 534.65,
            "travel_time": "02:10:00",
            "arrival_date_time": "2024-01-05 19:00:00",
            "waiting_time": "",
            "vehicle_type_id": 4
          }
        }
      }
    },
    "is_return": 1,
    "route_from_code": "airport-1",
    "route_to_code": "resort-22",
    "return_route_to_code": "airport-3",
    "outbound_date": "2023-12-23",
    "outbound_time_hours": 11,
    "outbound_time_minutes": 5,
    "outbound_selected_time_is_flight": 1,
    "return_date": "2024-01-05",
    "return_time_hours": 21,
    "return_time_minutes": 0,
    "return_selected_time_is_flight": 1,
    "adult_count": 2,
    "children_count": 1,
    "return_adult_count": 2,
    "return_children_count": 1
  },
  "AdditionalInformation": {
    "booster_seat_count": 1,
    "child_seat_count": 0,
    "ski_count": 1,
    "snowboard_count": 0,
    "return_booster_seat_count": 1,
    "return_child_seat_count": 0,
    "return_ski_count": 1,
    "return_snowboard_count": 1,
    "accommodation_name": "Hotel Name",
    "accommodation_address": "Hotel Address",
    "accommodation_coordinates": "46.341883, 11.539972",
    "flight_number": "FL123",
    "return_flight_number": "FL321",
    "additional_information": ""
  }
}

Successful booking response data will contain booking reference and Base64 encoded PDF vouchers for each product, indexed by product references. You can set optional property return_vouchers to 0, if you do not wish to receive the vouchers in response data and decrease response time. Vouchers can be requested through the API at a later time and will also be delivered to your account's email address upon booking creation.

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE INPUT

{
  "Booking": {
    "transfer_id": 123456,
    "return_vouchers": 1,
    "TransferSelection": {
      "outbound": "off_peak-0-2",
      "return": "requested-4"
    },
    "Customer": {
      "name": "John",
      "last_name": "Smith",
      "email": "john.smith@domain.com",
      "country_code": "+371",
      "mobile_number": "324124698",
      "reference": ""
    }
  }
}

EXAMPLE OUTPUT

{
  "Booking": {
    "reference": "AMI3453",
    "vouchers": {
      "AMI3453-P1": ...
      "AMI3453-P2": "..."
    }
  }
}

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "Booking": {
    "reference": "AMI3453",
    "vouchers": {
      "AMI3453-P1": ...
      "AMI3453-P2": "..."
    }
  }
}

Method returns transfer destination names mapped by corresponding destination codes that create a valid route with the destination based on the provided code.

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "resort-262": "Adelboden",
  "resort-226": "Bern",
  "resort-267": "Chateau d'Oex",
  "resort-229": "Chur",
  ...
}

Method returns an array of base prices based on passenger count and vehicle type for all routes or routes containing a specific destination based on provided destination code.

To return only recently added or changed base prices you should add the optional parameter since containing the Unix timestamp of the earliest time to check.

Please note that returned vehicle in case of shared transfers is not the transfer vehicle but instead the vehicle that is used to find the correct markup.

Additional optional request parameters can be provided:

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "airport-1": {
    "resort-1": [
      {
        "vehicle": "2",
        "pax_min": "1",
        "pax_max": "2",
        "price": "231"
      },
      {
        "vehicle": "3",
        "pax_min": "3",
        "pax_max": "3",
        "price": "248"
      }
    ],
    "resort-2": [
      {
        "vehicle": "2",
        "pax_min": "1",
        "pax_max": "2",
        "price": "277"
      },
      {
        "vehicle": "2",
        "pax_min": "3",
        "pax_max": "3",
        "price": "336"
      }
    ]
  },
  "airport-2": {
    "resort-2": [
      {
        "vehicle": "3",
        "pax_min": "1",
        "pax_max": "2",
        "price": "330"
      },
      {
        "vehicle": "10",
        "pax_min": "3",
        "pax_max": "3",
        "price": "385"
      }
    ]
  }
}

Method returns an array of all active and upcoming markup rules list for all routes or routes containing a specific destination based on provided destination code.

Returned data is separated into pages and you should query each page by adding the optional parameter page. You can also change the page size by setting the optional parameter size, which has a default value of 1000.

Usage rules:

• Weekdays are represented by numbers 1 through 7 and correspond to Monday through Sunday accordingly;
• Level represents markup rule priority - if transfer time matches two rules, higher level rule must be applied;
• Route direction matters - routes array keys represent departure point and each key contains a list of codes for the arrival point.

Additional optional request parameters can be provided:

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT (type=private)

{
  "pages": 67,
  "page": 1,
  "data": [
    {
      "vehicle": "2",
      "weekday_from": "6",
      "weekday_to": "6",
      "date_from": "2021-12-01",
      "date_to": "2021-12-13",
      "time_from": "00:00:00",
      "time_to": "05:00:00",
      "percentage": "70",
      "level": "5",
      "routes": {
        "airport-1": [
          "resort-1",
          "resort-2",
          "resort-3",
          "resort-4"
        ],
        "airport-2": [
          "resort-1",
          "resort-2",
          "resort-3"
        ]
      }
    },
    {
      "vehicle": "2",
      "weekday_from": "6",
      "weekday_to": "6",
      "date_from": "2021-12-01",
      "date_to": "2021-12-13",
      "time_from": "09:00:00",
      "time_to": "14:00:00",
      "percentage": "80",
      "level": "5",
      "routes": {
        "resort-1": [
          "airport-1",
          "train_station-11"
        ],
        "resort-2": [
          "airport-1",
          "airport-2",
          "airport-3"
        ]
      }
    }
  ]
}

Method returns an array of destination codes for each of destinations representing all valid routes.

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "airport-1": [
    "resort-1",
    "resort-2",
    ...
    "resort-499",
    "resort-500"
  ],
  ...
  "resort-418": [
    "airport-39",
    "airport-40",
    "airport-41"
  ],
  ...
}

Method returns route configuration.

Information provided by route configuration can be used to avoid sending transfer requests that are not available for online booking.

Following parameters will be returned:

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "max_passengers": 49
}

Method returns a list of available vehicles mapped by corresponding IDs.

Each vehicle list object contains the following attributes:

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

EXAMPLE OUTPUT

{
  "2": {
    "id": "2",
    "name": "Standard\/economy",
    "description": "VW Passat, Volvo V70, Pegueot 508 or similar vehicle",
    "image_link": "https:\/\/www.alps2alps.com\/img\/vehicles\/2.png",
    "max_passengers": "3",
    "can_transport_skis": "0"
  },
  ...
  "16": {
    "id": "16",
    "name": "49-seater bus",
    "description": "Mercedes, Scania, Volvo or similar",
    "image_link": "https:\/\/www.alps2alps.com\/img\/vehicles\/16.png",
    "max_passengers": "49",
    "can_transport_skis": "1"
  }
}

Transfer attributes:

ⓘ This method requires authorization. Add Authorization: Bearer <token> header to your request.

MINIMAL ONE-WAY EXAMPLE INPUT

{
  "Transfer": {
    "is_return": 0,
    "route_from_code": "airport-1",
    "route_to_code": "resort-22",
    "outbound_date": "2023-12-23",
    "outbound_time_hours": 11,
    "outbound_time_minutes": 5,
    "adult_count": 2
  }
}

MINIMAL ROUND-TRIP EXAMPLE INPUT

{
  "Transfer": {
    "route_from_code": "airport-1",
    "route_to_code": "resort-22",
    "outbound_date": "2023-12-23",
    "outbound_time_hours": 11,
    "outbound_time_minutes": 5,
    "return_date": "2024-01-05",
    "return_time_hours": 21,
    "return_time_minutes": 0,
    "adult_count": 2,
    "return_adult_count": 2
  }
}

Full Example

EXAMPLE INPUT

{
  "Transfer": {
    "is_return": 1,
    "route_from_code": "airport-1",
    "route_to_code": "resort-22",
    "return_route_to_code": "airport-3",
    "outbound_date": "2023-12-23",
    "outbound_time_hours": 11,
    "outbound_time_minutes": 5,
    "outbound_selected_time_is_flight": 1,
    "return_date": "2024-01-05",
    "return_time_hours": 21,
    "return_time_minutes": 0,
    "return_selected_time_is_flight": 1,
    "adult_count": 2,
    "children_count": 1,
    "return_adult_count": 2,
    "return_children_count": 1
  }
}

EXAMPLE OUTPUT

{
  "link": "https:\/\/www.alps2alps.com\/en\/booking\/b2b2c?key=abcdefghijklmnopqrstuvwxyz20231011150637"
}