Documentation

Dashboard Menu

Optional extras confirmations RQ examples

Overview

The following section provides a series of examples illustrating how request confirmations with Optional Extras should be requested, this includes One Way and Two way services, Confirmation with GPS, etc.

OPTIONAL EXTRAS CODES
You can find all available codes and translations at the following link

Important: For SHARED services, the quantity requested for each optional extra cannot exceed the number of passengers included in the booking. For PRIVATE services, the maximum quantity allowed is determined by the vehicle capacity. Requests exceeding these limits will be rejected during the booking process./b>.

One way request to ATLAS CODE

{
  "language": "en",
    "holder": {
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "+16543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|IATA|BCN|ATLAS|57|2026-05-08|10:00|2026-05-08|10:00|2~0~0||99|||||102|SHRD||SH|STND|36.80||||39|57|SIMPLE|922c2ee1af89d61fe7cdbee26d908e73|1396587|T|ab4a2f55d45dddd5c84876c488b8b4d7|2026-01-23|09:09",
            "transferDetails": [
              {
                "type": "FLIGHT",
                "direction": "ARRIVAL",
                "code": "XR1234",
                "companyName": "TBC"
              }
          ],
          "extras": [
                {
                    "units": "1",
                    "code": "T05"
                }
            ]
        }
    ],

    "clientReference": "BOSTON#12-203#456754",
    "welcomeMessage": "Welcome Mr.Doe",
    "remark": "Remarks go here."
}

Round way request to ATLAS CODE

{
    "language": "en",
    "holder": {
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "+16543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|PORT|277|ATLAS|189097|2026-06-10|15:00|2026-06-10|15:00|2~1~0||3|||||102|PRVT||CR|STND|80.35||||43|189097|SIMPLE|09e4ab2ef0feb31f8e4c6441b4a1f67a|1396757|R|ab4a2f55d45dddd5c84876c488b8b4d7|2026-01-23|09:17",
            "transferDetails": [
              {
                "type": "CRUISE",
                "direction": "ARRIVAL",
                "code": "GRANDIOSA",
                "companyName": "MSC"
              }
          ],
           "extras": [
                {
                    "units": "1",
                    "code": "T04"
                }
            ]
        },
        {
            "rateKey": "DEPARTURE|ATLAS|189097|PORT|277|2026-06-20|12:00|2026-06-20|15:00|2~1~0||3|||||102|PRVT||CR|STND|80.35||||43|277|SIMPLE|607a65429afa8c4117c5867e817ae79f|1396757|R|ab4a2f55d45dddd5c84876c488b8b4d7|2026-01-23|09:17",
            "transferDetails": [
              {
                "type": "CRUISE",
                "direction": "DEPARTURE",
                "code": "GRANDIOSA",
                "companyName": "MSC"
              }
          ],
            "extras": [
                {
                    "units": "1",
                    "code": "T04"
                }
            ]
        }
    ],
 "clientReference": "BOSTON#12-203#456754",
    "welcomeMessage": "Welcome Mr.Doe",
    "remark": "Remarks go here."
}

One way request to GPS CODE

{
  "language": "en",
    "holder": {
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "+16543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|STATION|930|ATLAS~GPS|1009~41.39347365813525, 2.1628669129116207|2026-08-08|10:00|2026-08-08|10:00|3~0~0||3|||||102|PRVT||CR|STND|58.83||||43|1009|SIMPLE|6fa43c117cb0bf912fa0283e3fafefda|1444438|T|ab4a2f55d45dddd5c84876c488b8b4d7|2026-01-23|09:28",
            "transferDetails": [
              {
                "type": "TRAIN",
                "direction": "ARRIVAL",
                "code": "1222",
                "companyName": "AVE"
              }
          ],
          "pickupInformation": {
              "name": "Name of the hotel or origin point",
              "address": "Name of the street",
              "town": "Town name",
              "country": "Country name",
              "zip": "PostalCode"
           },
          "extras": [
                {
                    "units": "1",
                    "code": "T12"
                }
            ]
        }
    ],

    "clientReference": "BOSTON#14-203#456754",
    "welcomeMessage": "Welcome Mr.Doe",
    "remark": "Remarks go here."
}

One way request between TERMINALS

{
  "language": "en",
    "holder": {
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@hotelbeds.com",
        "phone": "+16543245812"
    },
    "transfers": [
        {
            "rateKey": "ARRIVAL|IATA|BCN|PORT|277|2026-09-08|10:00|2026-09-08|10:00|4~0~0||7|||||102|PRVT||MNBS|STND|130.44||||2|277|SIMPLE|27330c4a18b25681481f73460a5c9f4f|1396037|T|ab4a2f55d45dddd5c84876c488b8b4d7|2026-01-23|09:33",
            "transferDetails": [
              {
                "type": "FLIGHT",
                "direction": "ARRIVAL",
                "code": "IB1222",
                "companyName": "IBERIA"
              },
               {
                "type": "CRUISE",
                "direction": "ARRIVAL",
                "code": "SPLENDID",
                "companyName": "CRUISE"
              }
          ],
          
          "extras": [
                {
                    "units": "1",
                    "code": "T12"
                }
            ]
        }
    ],

    "clientReference": "BOSTON#14-203#456754",
    "welcomeMessage": "Welcome Mr.Doe",
    "remark": "Remarks go here."
}