Day-wise Itinerary

The Day-wise Itinerary API returns the plan of a package day by day: the city for each day and its transfers and activities. Use it to build the day-wise plan on the package details page. Hotels and flights are not in this response; add them from the Package Details API.

Request Path Parameters

ParameterTypeRequiredDescription
codeStringYesPackage ID, from listings[].code in the Listing API, e.g. fdljkyw.

Response Body Structure

Root

KeyTypeDescription
statusInteger200 on success.
dataArray of ObjectsOne item per day, in order. See data[].

data[]

One day of the plan. Show one section per item, sorted by dayCount. The date of a day is the selected departure's travel_start_date plus dayCount minus 1, e.g. Day 2 of a trip starting Tue, 17 Nov is Wed, 18 Nov. Show areaName as the city for the day, and hide it when it is null. A day with an empty components list and no hotel check-in or flight is a day at leisure.

KeyTypeDescription
areaCodeString or nullArea ID of the city for the day.
areaNameString or nullCity name for the day, e.g. Pattaya.
dayStringDay label, e.g. Day - 2.
dayCountIntegerDay number, starting at 1.
componentsArray of ObjectsTransfers and activities planned on the day, in order. Empty on a free day. See data[].components[].

data[].components[]

A transfer or an activity planned on the day. Show the components in the order returned. itemType tells you what each one is:

  • 2 is a transfer: show title (e.g. Arrival, Inter hotel transfer, Departure), pickUpPoint → dropPoint, the vehicle in mode, shared (SIC) or private from transferType, and the number of vehicles from totalCabs, e.g. "Bus (occupancy 10) · Shared · 1 cab". If the matching transfer in Package Details (same code) has addons[], offer the transfer upgrade on this card.
  • 0 is an activity: show title, shared or private from transferType, and the first image in additionalDetails.images.
KeyTypeDescription
orderInteger or nullPosition of an activity. Only on activities.
titleStringActivity name, or the transfer label: Arrival, Inter hotel transfer or Departure.
pickUpPointString or nullWhere a transfer starts. null for activities.
dropPointString or nullWhere a transfer ends. null for activities.
transferTypeStringSIC (shared) or PRIVATE.
codeStringTransfer or activity ID. Matches transfers[].transfer.code or sightseeings[].sightseeing.code in Package Details.
modeString or nullVehicle, e.g. Bus (occupancy 10). null for activities.
totalCabsInteger or nullNumber of vehicles. null for activities.
itemTypeIntegerKind of item: 2 is a transfer, 0 an activity.
additionalDetailsObjectDescription and images. See components[].additionalDetails.

components[].additionalDetails

KeyTypeDescription
descriptionStringDetails (HTML). Sanitize before showing.
imagesArray of StringsActivity images. Only on activities.

Adding Hotels, Flights and Add-ons

This response has only transfers and activities. Combine it with the Package Details response to show the full plan:

From Package DetailsWhere it goes in the plan
hotels[]On the day given by day_of_trip, right after the transfer whose dropPoint is the hotel. On the following nights of the stay, show "Staying at {hotel} · night 2 of 3".
flights[] with is_primary: trueIts outbound journey first on Day 1, and its inbound journey last on the final day. If inbound is null or has no segments, show only the outbound.
Other flights[]On the day given by day_of_trip, for example an inter-city flight such as Hanoi to Da Nang on a Vietnam package.
addons[] (optional activities)On the day given by day_of_trip, after that day's included activities, with an Add button. On a day at leisure, show them as suggestions.
hotels[].upgrades[]As an upgrade option on the hotel's card.
flights[].outbound.origin_addons[]As a "Start from another city" option on the Day 1 flight.

Sample Response

Response for package fdljkyw (4N Pattaya Bangkok EX-DEL).

{
  "status": 200,
  "data": [
    {
      "areaCode": null,
      "areaName": null,
      "day": "Day - 1",
      "dayCount": 1,
      "components": []
    },
    {
      "areaCode": "arjk49",
      "areaName": "Pattaya",
      "day": "Day - 2",
      "dayCount": 2,
      "components": [
        {
          "title": "Arrival",
          "pickUpPoint": "Don Mueang International Airport",
          "dropPoint": "Mind Resort",
          "transferType": "SIC",
          "code": "fdtjk4w",
          "mode": "Bus (occupancy 10)",
          "totalCabs": 1,
          "itemType": 2,
          "additionalDetails": {
            "description": "Transfer from DMK to…"
          }
        },
        {
          "order": 0,
          "title": "69 Show or Russian Show…",
          "pickUpPoint": null,
          "dropPoint": null,
          "transferType": "SIC",
          "code": "ssgjzls",
          "mode": null,
          "totalCabs": null,
          "itemType": 0,
          "additionalDetails": {
            "description": "<p><span>Dive into a…",
            "images": [
              "https://…/img-88.png"
            ]
          }
        }
      ]
    },
    {
      "areaCode": "arjk49",
      "areaName": "Pattaya",
      "day": "Day - 3",
      "dayCount": 3,
      "components": [
        {
          "order": 0,
          "title": "Coral Island Tour with…",
          "pickUpPoint": null,
          "dropPoint": null,
          "transferType": "SIC",
          "code": "ssgjzxo",
          "mode": null,
          "totalCabs": null,
          "itemType": 0,
          "additionalDetails": {
            "description": "<p><span>Embark on a…",
            "images": [
              "https://…/1-33.png"
            ]
          }
        }
      ]
    },
    {
      "areaCode": "arjk49",
      "areaName": "Pattaya",
      "day": "Day - 4",
      "dayCount": 4,
      "components": []
    },
    {
      "areaCode": "arjkyh",
      "areaName": "BANGKOK",
      "day": "Day - 5",
      "dayCount": 5,
      "components": [
        {
          "title": "Inter hotel transfer",
          "pickUpPoint": "Mind Resort",
          "dropPoint": "Cross Vibe Sukhumvit Hotel",
          "transferType": "SIC",
          "code": "fdtjk4i",
          "mode": "Bus (occupancy 10)",
          "totalCabs": 1,
          "itemType": 2,
          "additionalDetails": {
            "description": ""
          }
        },
        {
          "order": 0,
          "title": "Bangkok City Temple…",
          "pickUpPoint": null,
          "dropPoint": null,
          "transferType": "SIC",
          "code": "ssgjzxe",
          "mode": null,
          "totalCabs": null,
          "itemType": 0,
          "additionalDetails": {
            "description": "<p><span>Embark on a…",
            "images": [
              "https://…/img-15.png"
            ]
          }
        }
      ]
    },
    {
      "areaCode": "arjkyh",
      "areaName": "BANGKOK",
      "day": "Day - 6",
      "dayCount": 6,
      "components": [
        {
          "title": "Departure",
          "pickUpPoint": "Cross Vibe Sukhumvit Hotel",
          "dropPoint": "Don Mueang International Airport",
          "transferType": "SIC",
          "code": "fdtjk40",
          "mode": "Bus (occupancy 10)",
          "totalCabs": 1,
          "itemType": 2,
          "additionalDetails": {
            "description": ""
          }
        }
      ]
    }
  ]
}

API Reference

https://volt-docs.travclan.com/reference/getdaywiseitinerary


Did this page help you?