{
  "info": {
    "name": "Voraal API · Transfer",
    "description": "Airport and city transfers with fixed prices.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Booking flow",
      "item": [
        {
          "name": "Search transfers",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/transfer/search",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "transfer",
                "search"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"segment\": [\n    {\n      \"departure_type\": \"AIRPORT\",\n      \"departure_code\": \"DXB\",\n      \"departure\": \"Dubai International Airport, Dubai\",\n      \"arrival_type\": \"LOC\",\n      \"arrival_code\": \"Dubai Mall - Dubai - United Arab Emirates\",\n      \"arrival\": \"Dubai Mall - Dubai - United Arab Emirates\",\n      \"outbound_date\": \"2027-03-15T00:00:00\"\n    }\n  ],\n  \"journey_type\": \"OneWay\",\n  \"travelers_adult\": 2,\n  \"travelers_adult_types\": [\n    \"\"\n  ],\n  \"travelers_child\": 0,\n  \"travelers_child_types\": [],\n  \"travelers_child_age\": [],\n  \"travelers_infants\": 0,\n  \"travelers_infants_age\": [],\n  \"travelers_infants_types\": [],\n  \"guest_nationality\": \"BD\",\n  \"transfer_type\": \"private\",\n  \"supplier_uid\": \"all\",\n  \"partner_id\": \"\",\n  \"short_ref\": \"xxxx111\",\n  \"language\": \"en\",\n  \"service_type\": \"regular\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Searches transfers for one or more route segments and passenger counts. Results are in `transfer_data[]` (not `data[]`) with `filter` facets."
          },
          "response": []
        },
        {
          "name": "Get single transfer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/transfer/single-transfer",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "transfer",
                "single-transfer"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tracking_id\": \"11772862765YXW1\",\n  \"transfer_id\": \"T1HS00025#0-43\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Prices one transfer from a search result and opens a booking session. The response carries `session_expire` and a `transfer_tracking_id` for the next steps."
          },
          "response": []
        },
        {
          "name": "Get transfer checkout validation status",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/transfer/validation-get-status",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "transfer",
                "validation-get-status"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"booking_tracking_id\": \"11178902162088132JZAAP\",\n  \"member_id\": \"1\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Called on the checkout page after the single-item step has already run. Returns the validated booking state for a booking tracking id. Do not call the single-item step again at checkout (it creates a second booking). b2b checks only `status === \"success\"` and uses the whole body."
          },
          "response": []
        },
        {
          "name": "Update transfer travellers",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/transfer/update-travellers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "transfer",
                "update-travellers"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"booking_tracking_id\": \"111772863275261949XMKY\",\n  \"member_id\": \"2\",\n  \"save_pax\": \"No\",\n  \"passenger\": [\n    {\n      \"pax_id\": \"1\",\n      \"pax_type\": \"ADT\",\n      \"title\": \"MR\",\n      \"first_name\": \"Jasim\",\n      \"last_name\": \"Kalam\",\n      \"age\": \"30\",\n      \"isd_code\": \"880\",\n      \"contact_no\": \"1966330000\",\n      \"email_address\": \"examplesaaqeb.com\"\n    },\n    {\n      \"pax_id\": \"2\",\n      \"pax_type\": \"ADT\",\n      \"title\": \"MR\",\n      \"first_name\": \"Jasim\",\n      \"last_name\": \"Kalam\",\n      \"age\": \"30\",\n      \"isd_code\": \"880\",\n      \"contact_no\": \"1966330000\",\n      \"email_address\": \"examplesaaqeb.com\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Saves passenger details against the booking_tracking_id. The number of passengers must match the searched guest count."
          },
          "response": []
        },
        {
          "name": "Create transfer booking",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/transfer/create-booking",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "transfer",
                "create-booking"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"booking_tracking_id\": \"11177303486226194YSHFB\",\n  \"transfer_tracking_id\": \"11177303486226194YSHFB||0-43\",\n  \"member_id\": \"1\",\n  \"isPartialPay\": \"no\",\n  \"note\": \"Note to driver\",\n  \"isd_code\": \"880\",\n  \"contact_no\": \"1966330000\",\n  \"email_address\": \"examplesaaqeb.com\",\n  \"agency_email\": \"examplesaaqeb.com\",\n  \"connected_segment\": [\n    {\n      \"segment_type\": \"FLIGHT\",\n      \"segment_point\": \"ARRIVAL\",\n      \"segment_code\": \"XA01-AB\",\n      \"transfer_point\": \"START\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Books the transfer and returns the booking id, voucher and pricing. Needs the booking and transfer tracking ids from the earlier steps."
          },
          "response": []
        },
        {
          "name": "Cancel transfer booking",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/transfer/cancel-booking",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "transfer",
                "cancel-booking"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": \"1\",\n  \"tracking_id\": \"11177303486226194YSHFB\",\n  \"reason\": \"not required\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Cancels a transfer booking by member_id and tracking_id and returns the refund reference."
          },
          "response": []
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://serviceapi.rezencia.com"
    }
  ]
}