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
| Parameter | Type | Required | Description |
|---|---|---|---|
code | String | Yes | Package ID, from listings[].code in the Listing API, e.g. fdljkyw. |
Response Body Structure
Root
| Key | Type | Description |
|---|---|---|
status | Integer | 200 on success. |
data | Array of Objects | One item per day, in order. See data[]. |
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.
| Key | Type | Description |
|---|---|---|
areaCode | String or null | Area ID of the city for the day. |
areaName | String or null | City name for the day, e.g. Pattaya. |
day | String | Day label, e.g. Day - 2. |
dayCount | Integer | Day number, starting at 1. |
components | Array of Objects | Transfers and activities planned on the day, in order. Empty on a free day. See data[].components[]. |
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:
2is a transfer: showtitle(e.g. Arrival, Inter hotel transfer, Departure),pickUpPoint→dropPoint, the vehicle inmode, shared (SIC) or private fromtransferType, and the number of vehicles fromtotalCabs, e.g. "Bus (occupancy 10) · Shared · 1 cab". If the matching transfer in Package Details (samecode) hasaddons[], offer the transfer upgrade on this card.0is an activity: showtitle, shared or private fromtransferType, and the first image inadditionalDetails.images.
| Key | Type | Description |
|---|---|---|
order | Integer or null | Position of an activity. Only on activities. |
title | String | Activity name, or the transfer label: Arrival, Inter hotel transfer or Departure. |
pickUpPoint | String or null | Where a transfer starts. null for activities. |
dropPoint | String or null | Where a transfer ends. null for activities. |
transferType | String | SIC (shared) or PRIVATE. |
code | String | Transfer or activity ID. Matches transfers[].transfer.code or sightseeings[].sightseeing.code in Package Details. |
mode | String or null | Vehicle, e.g. Bus (occupancy 10). null for activities. |
totalCabs | Integer or null | Number of vehicles. null for activities. |
itemType | Integer | Kind of item: 2 is a transfer, 0 an activity. |
additionalDetails | Object | Description and images. See components[].additionalDetails. |
components[].additionalDetails
components[].additionalDetails| Key | Type | Description |
|---|---|---|
description | String | Details (HTML). Sanitize before showing. |
images | Array of Strings | Activity 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 Details | Where 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: true | Its 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
Updated 4 days ago
