getoptionals

Returns the optional services available for a tour (extras/add-ons).

This endpoint returns the list of optional services available for a tour and date range. It does not calculate the total amount for a reservation.

endpoints

production

https://newapi.vpttours.com/getoptionals

request parameters

brochure

[int][required]

Brochure code.

code

[int][required]

Tour code.

language

[int]

Language code in which we want to make the request.

start_date

[date][required]

Start date of the tour.

end_date

[date][required]

End date of the tour.

response data

codempre

[int]

Company code.

codfovia

[int]

codfovia is the equivalent of brochure.

coditine

[int]

coditine is the optional service code.

desitine

[string]

Optional service description.

permiweb

[int]

Indicates if the optional service is allowed on the web.

codpobla

[int]

City code related to the optional service.

despobla

[string]

City name related to the optional service.

precio

[decimal]

Optional service unit price per passenger/person.

This value is not the total reservation amount.

precio_nino

[decimal|null]

Optional service unit price per child, when applicable.

If null, no specific child price is available.

comision

[decimal]

Commission percentage applied to the optional service.

coddivisa

[int]

Currency code.

simdivisa

[string]

Currency symbol.

fechaini

[date]

Start date of the optional service.

important note

The prices returned by getoptionals are unit prices per passenger/person.

This endpoint only returns the optional services available for a tour and date range. It does not calculate the total amount for a booking or reservation, because passenger occupancy is not required in this request.

To calculate or book an optional service, the selected optional service must be sent in the corresponding quotation/booking flow with the paxs node.

In that response, the API will return the quantity and the total amount calculated according to the passengers sent.

Example:

Optional service unit price: 111 USD
Passengers sent in booking request: 7
Total amount returned by API: 777 USD

request example

{
  "logindata": {
    "useremail": "{{vpt_login}}",
    "userpass": "{{vpt_pass}}",
    "integrator_token": "XXXXXX"
  },
  "requestdata": {
    "brochure": 211,
    "code": 51820,
    "start_date": "2025-06-28",
    "end_date": "2025-07-15",
    "language": "1"
  }
}

response example

[
  {
    "codempre": "1",
    "codfovia": "235",
    "coditine": "18",
    "desitine": "BARRIO LATINO Y BARRIO DE MONTMARTRE",
    "permiweb": "0",
    "codpobla": "823",
    "despobla": "PARIS",
    "precio": "65.00",
    "precio_nino": null,
    "comision": "10.00",
    "coddivisa": "2",
    "simdivisa": "USD",
    "fechaini": "2025-07-02"
  },
  {
    "codempre": "1",
    "codfovia": "235",
    "coditine": "14",
    "desitine": "CRUCERO E ILUMINACIONES DE PARIS",
    "permiweb": "0",
    "codpobla": "823",
    "despobla": "PARIS",
    "precio": "83.00",
    "precio_nino": null,
    "comision": "10.00",
    "coddivisa": "2",
    "simdivisa": "USD",
    "fechaini": "2025-07-02"
  },
  {
    "codempre": "1",
    "codfovia": "235",
    "coditine": "24",
    "desitine": "VERSALLES CON PALACIO Y JARDINES",
    "permiweb": "0",
    "codpobla": "823",
    "despobla": "PARIS",
    "precio": "106.00",
    "precio_nino": null,
    "comision": "10.00",
    "coddivisa": "2",
    "simdivisa": "USD",
    "fechaini": "2025-07-02"
  }
]