Sign in

v1

latestOpenAPI 3.0.02026-08-061029011.1 MB
Booking

Add Single Traveler

Send the Add Traveler request to add a single traveler to the reservation workbench. Traveler information can include traveler name and contact details, add traveler-specific remarks including certain SSRs and travel documents such as a passport.
Add each traveler to the same workbench with separate POST requests.
Alternatively, use air/book/traveler/reservationworkbench/{workbenchID}/travelers/list when adding multiple travelers.

post/air/book/traveler/reservationworkbench/{ReservationResource_Identifier}/travelers

Path parameters

ReservationResource_Identifierstring required
Example:49f58f5f-c443-43b4-9f5d-be405fd00a01

The Reservation Identifier you wish to add the Traveler information to

Headers

TraceIdstring
Example:TraceID_123456789

Identifier used to correlate Air API invocations across a multi-call business flows.

XAUTH_TRAVELPORT_ACCESSGROUPstring
Example:19Y88702-C27A-4E5D-829A-89D7016688B1

Identifies the Travelport access group with which the caller is associated

travelportPlusSessionIdentifierstring
Example:49f58f5f-c443-43b4-9f5d-be405fd00a01

travelportPlusSessionIdentifier used to maintain an established agency session

TVP-PCC-Corestring
Example:DU7_1G

Allows user to pass PCC instead of Access Group ID

Request body

@typestring required

Discriminator classes TravelerID or Traveler

idstring
TravelerRefstring
birthDatestring date

Date of birth in YYYY-MM-DD format.
The TripServices APIs require this object only for infant and child PTC types (e.g., INF, INS, CHD, UNN).
When sending minimum secure flight information, which is required by some carriers, this object is required for all PTCs.

gender'Male' | 'Female' | 'Unknown' | 'Undisclosed'

Gender Type Male, Female etc.
When sending minimum secure flight information in the Traveler object, which is required by some carriers, this object is required for all PTCs.
This field is not used by Hotel APIs and will be ignored.

passengerTypeCodestring

Passenger type code (PTC) for this traveler.

nationalitystring

Nationality on country code ISO

ageinteger

The age of the traveller at the time of travel

accompaniedByInfantIndboolean

Example request

{
  "@type": "Traveler",
  "Identifier": {
    "value": "A0656EFF-FAF4-456F-B061-0161008D7C4E",
    "authority": "TVPT"
  },
  "birthDate": "2021-06-05",
  "gender": "Female",
  "PersonName": {
    "@type": "PersonNameDetail",
    "Prefix": "Mr",
    "Given": "John",
    "Middle": "Erick",
    "Surname": "Smith"
  },
  "Address": [
    {
      "@type": "AddressDetail",
      "id": "Address_1",
      "BldgRoom": {
        "value": "Moore House",
        "buldingInd": true
      },
      "Number": {
        "value": "23B",
        "streetNmbrSuffix": "B",
        "streetDirection": "NW",
        "ruralRouteNmbr": "76",
        "po_Box": "1001"
      },
      "Street": "ABC Street",
      "AddressLine": [
        "2035 S Havana street"
      ],
      "City": "Dublin",
      "County": "Berkshire",
      "StateProv": {
        "value": "CA",
        "name": "California"
      },
      "Country": {
        "value": "US",
        "id": "23",
        "name": "United States",
        "codeContext": "IATA"
      },
      "PostalCode": "Sl6 1AB",
      "Addressee": "ACME INC",
      "role": "Business"
    }
  ],
  "Telephone": [
    {
      "@type": "Telephone",
      "countryAccessCode": "1",
      "areaCityCode": "972",
      "phoneNumber": "972-000-787",
      "extension": "234",
      "id": "3",
      "cityCode": "DEN",
      "role": "Mobile"
    }
  ],
  "Email": [
    {
      "value": "exampledomain@example.com",
      "id": "email_1",
      "emailType": "FROM",
      "comment": "work email",
      "preferredFormat": "text/html",
      "shareMarketing": "Yes",
      "shareSync": "Yes",
      "optOutInd": "Yes",
      "optInDate": "2026-03-03T11:11:00Z",
      "optOutDate": "2026-03-03T11:11:00Z",
      "validInd": true,
      "provisionedInd": true
    }
  ],
  "passengerTypeCode": "CHD",
  "nationality": "AL",
  "age": 13,
  "CustomerLoyalty": [
    {
      "value": "132456",
      "id": "Loyalty_1",
      "priority": 2,
      "programId": "HY",
      "programName": "Frontier-EarlyReturns",
      "supplierType": "Hotel",
      "supplier": "UA",
      "tier": "Silver",
      "shareWithSupplier": [
        "[\"AF\",\"KL\"]"
      ],
      "cardHolderName": "John Smith",
      "validatedInd": true,
      "prefix": "Dr",
      "given": "John",
      "middle": "Wilkinson",
      "surname": "Smith"
    }
  ],
  "AlternateContact": [
    {
      "@type": "AlternateContact",
      "contactType": "Relative",
      "relation": "Mother",
      "PersonName": {
        "@type": "PersonNameDetail",
        "Prefix": "Mr",
        "Given": "John",
        "Middle": "Erick",
        "Surname": "Smith"
      },
      "Address": [
        {
          "@type": "AddressDetail",
          "id": "Address_1",
          "BldgRoom": {
            "value": "Moore House",
            "buldingInd": true
          },
          "Number": {
            "value": "23B",
            "streetNmbrSuffix": "B",
            "streetDirection": "NW",
            "ruralRouteNmbr": "76",
            "po_Box": "1001"
          },
          "Street": "ABC Street",
          "AddressLine": [
            "2035 S Havana street"
          ],
          "City": "Dublin",
          "County": "Berkshire",
          "StateProv": {
            "value": "CA",
            "name": "California"
          },
          "Country": {
            "value": "US",
            "id": "23",
            "name": "United States",
            "codeContext": "IATA"
          },
          "PostalCode": "Sl6 1AB",
          "Addressee": "ACME INC",
          "role": "Business"
        }
      ],
      "Telephone": [
        {
          "@type": "Telephone",
          "countryAccessCode": "1",
          "areaCityCode": "972",
          "phoneNumber": "972-000-787",
          "extension": "234",
          "id": "3",
          "cityCode": "DEN",
          "role": "Mobile"
        }
      ],
      "Email": [
        {
          "value": "exampledomain@example.com",
          "id": "email_1",
          "emailType": "FROM",
          "comment": "work email",
          "preferredFormat": "text/html",
          "shareMarketing": "Yes",
          "shareSync": "Yes",
          "optOutInd": "Yes",
          "optInDate": "2026-03-03T11:11:00Z",
          "optOutDate": "2026-03-03T11:11:00Z",
          "validInd": true,
          "provisionedInd": true
        }
      ],
      "emergencyInd": true,
      "defaultInd": true
    }
  ],
  "TravelDocument": [
    {
      "@type": "TravelDocumentDetail",
      "docNumber": "B37201",
      "docType": "Passport",
      "issueDate": "2002-10-13",
      "expireDate": "2002-11-13",
      "stateProvCode": "44",
      "placeOfIssue": "Birmingham",
      "issueCountry": "CA",
      "birthDate": "1995-04-22",
      "birthCountry": "AR",
      "birthPlace": "Ontario",
      "residence": "1st section 8th st",
      "id": "34",
      "Gender": "Female",
      "Nationality": "BR",
      "PersonName": {
        "@type": "PersonNameDetail",
        "Prefix": "Mr",
        "Given": "John",
        "Middle": "Erick",
        "Surname": "Smith"
      }
    }
  ],
  "Comments": {
    "@type": "Comments",
    "Comment": [
      {
        "value": "Additional comments",
        "id": "comment_1",
        "name": "Comment name",
        "language": "EN"
      }
    ]
  },
  "RailDiscountCard": [
    {
      "value": "Rail1234546",
      "supplierCode": "Enco",
      "referenceNumber": "134256"
    }
  ],
  "accompaniedByInfantInd": true
}

Response

OK - Successful Response - 200

Example response

{
  "TravelerResponse": {
    "@type": "response",
    "transactionId": "49f58f5f-c443-43b4-9f5d-be405fd00a01",
    "traceId": "TraceID_123456",
    "Result": {
      "@type": "Result",
      "status": "Complete",
      "Error": [
        {
          "@type": "ErrorDetail",
          "StatusCode": 200,
          "Message": "No flights found.",
          "NameValuePair": [
            {
              "value": "Sunday",
              "id": "6",
              "name": "Day1"
            }
          ]
        }
      ],
      "Warning": [
        {
          "@type": "WarningDetail",
          "StatusCode": 200,
          "Message": "Customer Loyalty could not be applied.",
          "NameValuePair": [
            {
              "value": "Sunday",
              "id": "6",
              "name": "Day1"
            }
          ]
        }
      ]
    },
    "Identifier": {
      "value": "A0656EFF-FAF4-456F-B061-0161008D7C4E",
      "authority": "TVPT"
    },
    "NextSteps": {
      "id": "5",
      "NextStep": [
        {
          "value": "www.resourcelocation.com",
          "id": "2",
          "action": "cancel",
          "description": "remove offer from the order"
        }
      ]
    },
    "ReferenceList": [
      {
        "@type": "ReferenceListFlight"
      }
    ],
    "CurrencyRateConversion": [
      {
        "SourceCurrency": {
          "value": "USD",
          "codeAuthority": "ISO 4217",
          "decimalPlace": 4,
          "decimalAuthority": "ISO 4217"
        },
        "TargetCurrency": {
          "value": "USD",
          "codeAuthority": "ISO 4217",
          "decimalPlace": 4,
          "decimalAuthority": "ISO 4217"
        },
        "ConversionRate": {
          "rateAuthority": "ISO 4217",
          "rateAsOf": "2026-08-07T12:12:00Z"
        }
      }
    ],
    "Pagination": {
      "@type": "Pagination",
      "page": 1,
      "pageSize": 20,
      "totalPages": 5,
      "totalItems": 100
    }
  }
}