Documentation

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.

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."
}