Passenger Info (PaxInfo) Object
Common passenger information structure used across multiple flight API endpoints.
PaxInfo Object Structure
| Field | Type | Required | Description |
|---|---|---|---|
| index | integer | Yes | Sequence number, starting from 1 |
| passengerId | string | No | Passenger ID (from RetrievePNR) |
| parentId | string | No | Adult passenger ID (for INF - infants only) |
| passengerType | string | Yes | Passenger type: ADT (Adult), CHD (Child), INF (Infant) |
| title | string | No | Title (MR, MS, MRS, MSTR) |
| gender | boolean | No | Gender (true: male, false: female) |
| givenName | string | Yes | Given and middle name |
| surname | string | Yes | Surname |
| dateOfBirth | string | No | Date of birth (YYYY-MM-DD, required for CHD/INF) |
| string | No | Contact email | |
| phone | string | No | Contact phone |
| membership | object | No | Membership info (see Membership below) |
| document | object | No | Document info (see Document below) |
Membership Object
| Field | Type | Required | Description |
|---|---|---|---|
| airline | string | No | Airline code |
| membershipId | string | No | Membership ID |
| level | string | No | Membership level |
| skyTeamLevel | string | No | SkyTeam level |
Document Object
| Field | Type | Required | Description |
|---|---|---|---|
| surName | string | No | Surname (as on document) |
| givenName | string | No | Given name (as on document) |
| dateOfBirth | string | No | Date of birth (YYYY-MM-DD) |
| gender | boolean | No | Gender (true: male, false: female) |
| number | string | Yes | Document number (max 15 chars) |
| type | string | Yes | Document type: P (passport), I (ID card) |
| national | string | No | Nationality (3 chars) |
| expiryDate | string | Yes | Expiry date (YYYY-MM-DD) |
| issueCountry | string | Yes | Country of issue (3 chars) |
| issueDate | string | No | Issue date (YYYY-MM-DD) |
Business Rules
passengerTypemust be one of: ADT, CHD, INF- For infants (INF),
parentIdmust reference a valid adult passenger dateOfBirthis required for CHD and INF passenger types- Document
typeandnumberare required when document info is provided expiryDatemust be in the future for document validation- Maximum 15 characters for document
number
Usage
This object structure is used in the following endpoints:
Example
{
"index": 1,
"passengerId": "PAX001",
"passengerType": "ADT",
"title": "MR",
"gender": true,
"givenName": "MINH",
"surname": "NGUYEN",
"dateOfBirth": "1990-01-01",
"email": "minh@example.com",
"phone": "+84901234567",
"membership": {
"airline": "VN",
"membershipId": "MEM123456",
"level": "GOLD",
"skyTeamLevel": null
},
"document": {
"number": "C1234567",
"type": "P",
"national": "VNM",
"expiryDate": "2030-01-01",
"issueCountry": "VNM",
"issueDate": "2020-01-01"
}
}