modreservationpax

Updates passenger data for an existing reservation.

This endpoint performs a partial update. Only fields included in requestdata are modified. Fields not sent in the request keep their current value.

endpoints

production

https://newapi.vpttours.com/modreservationpax

request parameters

reservationcode
[int][required]

Reservation locator.


paxid
[int][required]

Passenger identifier returned by getreservationpaxs.


name
[string]

Passenger first name.


surname
[string]

Passenger surname.


passport
[string]

Passport or document number.


doc_fecha_exp
[date:yyyy-mm-dd]

Document issue date.


doc_fecha_cad
[date:yyyy-mm-dd]

Document expiration date.


nationality
[string:2]

Passenger nationality code.

Example: ES.


email
[string]

Passenger email address.


phone
[string]

Passenger phone number.

When using application/x-www-form-urlencoded, remember that + must be encoded correctly.

For example:

+34611111111

may need to be sent as:

%2B34611111111

birthdate
[date:yyyy-mm-dd]

Passenger birth date.


age
[int]

Passenger age.


transferin
[object]

Arrival flight data.

Available fields:

airport
[string]

Airport code or value associated with the arrival transfer.

aircompany
[string]

Airline.

flightnumber
[string]

Flight number.

flighttime
[datetime:yyyy-mm-dd hh:mm]

Flight date and time.


transferout
[object]

Departure flight data.

Available fields:

airport
[string]

Airport code or value associated with the departure transfer.

aircompany
[string]

Airline.

flightnumber
[string]

Flight number.

flighttime
[datetime:yyyy-mm-dd hh:mm]

Flight date and time.


request example

{
    "logindata": {
        "useremail": "user@agency.com",
        "userpass": "********",
        "integrator_token": "********"
    },
    "requestdata": {
        "reservationcode": 123456,
        "paxid": 1,
        "name": "Test name modified",
        "phone": "+34611111111",
        "transferin": {
            "airport": "MAD",
            "aircompany": "IB",
            "flightnumber": "1234",
            "flighttime": "2027-12-12 14:35"
        }
    }
}

response data

Returns the updated passenger.

response example

{
    "id": "1",
    "name": "Test name modified",
    "surname": "Test surname",
    "passport": "P123456",
    "doc_fecha_exp": null,
    "doc_fecha_cad": null,
    "nationality": null,
    "email": null,
    "phone": "+34611111111",
    "birthdate": null,
    "age": "30",
    "transferin": {
        "airport": "MAD",
        "aircompany": "IB",
        "flightnumber": "1234",
        "flighttime": "2027-12-12 14:35"
    },
    "transferout": null
}

update rules

Only fields sent in the request are modified.

For example:

{
    "requestdata": {
        "reservationcode": 123456,
        "paxid": 1,
        "name": "New name"
    }
}

updates only name.

The rest of the passenger data, including transfer information, remains unchanged.


modification restrictions

Passenger data cannot be modified when:

The API also validates passenger and flight data formats.


functional errors

3001
reservation/passenger not found or not accessible

3009
passenger data cannot be modified less than 21 days before departure

3010
passenger data cannot be modified because the tour has already been closed by Operations

3015
invalid email format

3016
invalid age value

3017
invalid date format, expected yyyy-mm-dd

3018
invalid nationality code