booktour

Make a tour or a sightseeing tour reservation.

Note:

• The "Tour fields" are only needed to make a tour reservation
• The "Sightseeing tour fields" are only needed to make a sightseeing tour reservation
• Circuit optionals require additional fields and follow a different booking structure (see section below)

endpoints

production

https://newapi.vpttours.com/booktour

request parameters

brochure

[int][required]

Tour brochure code.

code

[int][required]

Tour code.

date

[date:yyyy-mm-dd][required]

Departure date.

reference

[string][required]

Client custom reference associated with the reservation.

language

[int]

Language code in which we want to make the request.

tour fields:

rooms

[array:room:1-5][required]

Rooming list data.

foodplan

[int][default AD]

Tour foodplan.

category

[int]

Tour chosen category.

prenights

[int:0-2]

Number of pre nights before the tour start.

postnights

[int:0-2]

Number of post nights after the tour end.

transferin

[transfer]

Transfer-in data.

transferout

[transfer]

Transfer-out data.

sightseeing tour fields:

paxs

[array:pax:0-99][required]

Passenger list.

pickup

[string:pickup]

Pickup code.

circuit optional fields:

Some optional services belong to an already confirmed circuit reservation.
These optionals are not sightseeing tours and must be booked as an add-on to an existing circuit booking.

The following fields are required for circuit optional reservations:

optional

[int][required only for circuit optionals]

Must be set to 1 to indicate that the request corresponds to an optional service attached to a circuit reservation.

reservationcode

[string][required only for circuit optionals]

Locator of the main circuit reservation to which the optional will be added.

Notes:

• Circuit optionals use the same brochure and code returned inside the optional list of the main tour (from GetTour / GetOptionals).
• paxs must match the passengers included in the main reservation.

Example – BookTour for a circuit optional

{
  "logindata": {
    "useremail": "*****",
    "userpass": "*****",
    "integrator_token": "xxxxxx"
  },
  "requestdata": {
    "pickup": "10001-1",
    "paxs": [
      {
        "age": 30,
        "name": "Test nombre",
        "surname": "Test apellido",
        "passport": "P123456"
      },
      {
        "age": 30,
        "name": "Test nombre",
        "surname": "Test apellido",
        "passport": "P123456"
      }
    ],
    "brochure": "235",
    "code": "1",
    "language": "1",
    "optional": "1",
    "reservationcode": "458273",
    "prenights": 0,
    "postnights": 0,
    "date": "2025-08-23",
    "reference": "Test referencia"
  }
}

response data

[price]

Detailed reservation price list.