AirShopping RQ - Virgin Atlantic NDC 21.3 API

Saved Successfully.

On this page

AirShopping RQ

Virgin Atlantic NDC 21.3 API

Last Updated: 23 Sep 2025 11:40

Schema Data Model

To access complete xml samples, click here

Request Definition

XML Snippet

Element

Details

DataType

M/O/C

<DistributionChain>

An instance of a distribution channel. That is, the set of organizations involved in the development of the current transaction.

<DistributionChain>
     <DistributionChainLink>
        <Ordinal>0</Ordinal>
          <OrgRole>Seller</OrgRole>
            <ParticipatingOrg>
               <Name>ABCTRAVEL</Name>
               <OrgID>SELLER001</OrgID>
            </ParticipatingOrg>
     </DistributionChainLink>
</DistributionChain>

XML Snippet

Element

Details

DataType

M/O/C

<Request>

AirShoppingRQ request information with O&D and Passenger details.

<FlightRelatedCriteria>

Preferred or required criteria for flight filters from the shopping response.

<FlightCriteria>

<FlightCharacteristicsCriteria>

Flight Characteristics Criteria filter.

<CharacteristicsCode>

Currently supported: Direct

Enum

<PrefLevel>

Info regarding the preference level of requested flight characteristics code.
XML Example

<CabinType>
    <CabinTypeCode>5</CabinTypeCode>
    <PrefLevel>
        <PrefLevelCode>Required</PrefLevelCode>
    </PrefLevel>
</CabinType>

<PrefLevelCode>

Default value is “Required”

Enum

<FlightRequest>

This is the flight request.
XML Example

<Request>
        <FlightRequest>
        ...
        </FlightRequest>
        <PaxList>
        ...
        </PaxList>
        <ResponseParameters xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
	    <CurParameter>
		<CurCode>USD</CurCode>
	    </CurParameter>
	</ResponseParameters>
</Request>

<FlightRequestOriginDestinationsCriteria>

Contains O&D and date information.

<OriginDestCriteria>

Origin and Destination airport/city pair which confines a passenger journey or an aircraft flight
XML Example

<OriginDestCriteria>
    <CabinType>
        <CabinTypeCode>5</CabinTypeCode>
        <PrefLevel>
            <PrefLevelCode>Required</PrefLevelCode>
        </PrefLevel>
    </CabinType>
    <DestArrivalCriteria>
        <IATA_LocationCode>JNB</IATA_LocationCode>
    </DestArrivalCriteria>
    <OriginDepCriteria>
        <Date>2023-05-07</Date>
        <IATA_LocationCode>LHR</IATA_LocationCode>
    </OriginDepCriteria>
</OriginDestCriteria>

List[1...*]

CabinType

List of cabins requested as part of the AirShopping service.
XML Example

<OriginDestCriteria>
<CabinType>
    <CabinTypeCode>5</CabinTypeCode>
    <PrefLevel>
        <PrefLevelCode>Required</PrefLevelCode>
    </PrefLevel>
</CabinType>
...
</OriginDestCriteria>

List[1...*]

<CabinTypeCode>

Cabin Type Code as defined by PADIS code set 9873
XML Example

<OriginDestCriteria>
<CabinType>
    <CabinTypeCode>5</CabinTypeCode>
    <PrefLevel>
        <PrefLevelCode>Required</PrefLevelCode>
    </PrefLevel>
</CabinType>
...
</OriginDestCriteria>

Note: Accepted ENUM codes: 2, 3, 4, 5 (PADIS 9873)
2 = Business
4 = Premium Economy
5 = Economy

ENUM

<PrefLevel>

Information supporting a preference including preference level code Examples: Preferred, Required or Exclude
XML Example

<CabinType>
    <CabinTypeCode>5</CabinTypeCode>
    <PrefLevel>
        <PrefLevelCode>Required</PrefLevelCode>
    </PrefLevel>
</CabinType>

<PrefLevelCode>

Predefined preference level codes.
XML Example

<CabinType>
    <CabinTypeCode>5</CabinTypeCode>
    <PrefLevel>
        <PrefLevelCode>Required</PrefLevelCode>
    </PrefLevel>
</CabinType>

Note: Default value is 'Required'
1. Preferred
2. Required
3. Exclude

String

<CalendarDateCriteria>

Request for Calendar led search

<DaysAfterNumber>

Number of days after the requested departure date

Note: DaysAfterNumber must be provided for calendar search

Integer

<DaysBeforeNumber>

Number of days before the requested departure date.

Note: DaysBeforeNumber must be provided for calendar search

Integer

<DestArrivalCriteria>

Contains the destination arrival time and location information.
XML Example

<DestArrivalCriteria>
     <IATA_LocationCode>JNB</IATA_LocationCode>
</DestArrivalCriteria>

<IATA_LocationCode>

IATA 3-letter code defining the destination location..
XML Example

<DestArrivalCriteria>
    <IATA_LocationCode>JNB</IATA_LocationCode>
</DestArrivalCriteria>

Char(3)

<OriginDepCriteria>

Customer's requested Origin departure time and location.
XML Example

<OriginDepCriteria>
    <Date>2023-05-07</Date>
    <IATA_LocationCode>LHR</IATA_LocationCode>
</OriginDepCriteria>

<Date>

Customer's requested departure date.
XML Example

<OriginDepCriteria>
    <Date>2023-05-07</Date>
    <IATA_LocationCode>LHR</IATA_LocationCode>
</OriginDepCriteria>

YYYY-MM-DD

<IATA_LocationCode>

IATA 3-letter code defining the departing location.
XML Example

<OriginDepCriteria>
    <Date>2023-05-07</Date>
    <IATA_LocationCode>LHR</IATA_LocationCode>
</OriginDepCriteria>

Char(3)

<Time>

Requested departure time.

DateTime

<TimeAfterDuration>

Time tolerance measured in hours after the requested departure time.

Note: TimeAfterDuration must be provided if search is based on departure time (i.e Time is provided).

String

<TimeBeforeDuration>

Time tolerance measured in hours before the requested departure time.

Note: TimeBeforeDuration must be provided if search is based on departure time (i.e Time is provided)

String

<OfferCriteria>

The advanced Offer Criteria that can part of the AirShopping Request

<FareCriteria>

Specific Fare Criteria associated with the requested fare product.

<FareTypeCode>

Note: PADIS Fare Qualifier Set:
1. 730 - Fares with no penalties
2. 731 - Fares with penalties

String

<PrefLevel>

Preference level of requested Fare Criteria.
XML Example

<PrefLevel>
  <PrefLevelCode>Required</PrefLevelCode>
</PrefLevel>

<PrefLevelCode>

Default value in "Required"
XML Example

<PrefLevel>
  <PrefLevelCode>Required</PrefLevelCode>
</PrefLevel>

String

<ProgramCriteria>

Release V2

A negotiated program identifier ( e.g. CLID, Corporate codes)
XML Example

<ProgramCriteria>
    <ProgramOwner>
        <Org>
            <Name>Corporate_name</Name>
            <OrgID>9000000000387</OrgID>
        </Org>
    </ProgramOwner>
</ProgramCriteria>

<ProgramOwner>

Release V2

XML Example

<ProgramCriteria>
    <ProgramOwner>
        <Org>
            <Name>Corporate_name</Name>
            <OrgID>9000000000387</OrgID>
        </Org>
    </ProgramOwner>
</ProgramCriteria>

<Org>

Release V2

Organisation detail
XML Example

<ProgramCriteria>
    <ProgramOwner>
        <Org>
            <Name>Corporate_name</Name>
            <OrgID>9000000000387</OrgID>
        </Org>
    </ProgramOwner>
</ProgramCriteria>

<Name>

Release V2

Corporate Name
XML Example

<ProgramCriteria>
    <ProgramOwner>
        <Org>
            <Name>Corporate_name</Name>
            <OrgID>9000000000387</OrgID>
        </Org>
    </ProgramOwner>
</ProgramCriteria>

String

<OrgID>

Release V2

Corporate ID (CLID)
XML Example

<ProgramCriteria>
    <ProgramOwner>
        <Org>
            <Name>Corporate_name</Name>
            <OrgID>9000000000387</OrgID>
        </Org>
    </ProgramOwner>
</ProgramCriteria>

String

<ServiceCriteria>

Optional Services expected to be returned in the Offer.

<IncludeInd>

Indicates that the taxonomy specification should be included when search for a Fare product

Boolean

<TaxonomyCode>

Service Taxonomy code that designates the specification that should be associated with the requested Fare Product.

Note: Accepted Taxonomy codes are:
1. 13EC
2. 189C
Where 13EC = Checked Bag and 189C = Preferred Seat

Alphanumeric

<ResponseParameters>

Release: 140425-01

This refers to the enhancement to enable agents (IATA/TIDS) to specify the currency in which the shopping can be made.
XML Example

<ResponseParameters xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes"> 
   <CurParameter>
      <CurCode>USD</CurCode>
    </CurParameter>
</ResponseParameters>

Note: In certain markets, multiple currencies may be used. In these cases, the agent can specify the desired currency via AirShoppingRQ. Once a purchase is made in a specific currency, all subsequent transactions must be conducted in the same currency. To ensure compliance, checks and validations are in place within OrderCreate and OrderChange.

Alphanumeric

<CurParameter>

Release: 140425-01

Indicate the currency in which the shopping can be made.
XML Example

<ResponseParameters xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes"> 
   <CurParameter>
      <CurCode>USD</CurCode>
    </CurParameter>
</ResponseParameters>

Alphanumeric

<CurCode>

Release: 140425-01

Currency Code as per ISO 4217
XML Example

<ResponseParameters xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes"> 
   <CurParameter>
      <CurCode>USD</CurCode>
    </CurParameter>
</ResponseParameters>

Char(3)

<Request>
        <FlightRequest>
            <FlightRequestOriginDestinationsCriteria>
                <OriginDestCriteria>
                    <CabinType>
                        <CabinTypeCode>5</CabinTypeCode>
                        <PrefLevel>
                            <PrefLevelCode>Required</PrefLevelCode>
                        </PrefLevel>
                    </CabinType>
                    <DestArrivalCriteria>
                        <IATA_LocationCode>JNB</IATA_LocationCode>
                    </DestArrivalCriteria>
                    <OriginDepCriteria>
                        <Date>2023-05-07</Date>
                        <IATA_LocationCode>LHR</IATA_LocationCode>
                    </OriginDepCriteria>
                </OriginDestCriteria>
                <OriginDestCriteria>
                    <CabinType>
                        <CabinTypeCode>5</CabinTypeCode>
                        <PrefLevel>
                            <PrefLevelCode>Required</PrefLevelCode>
                        </PrefLevel>
                    </CabinType>
                    <DestArrivalCriteria>
                        <IATA_LocationCode>LHR</IATA_LocationCode>
                    </DestArrivalCriteria>
                    <OriginDepCriteria>
                        <Date>2023-05-16</Date>
                        <IATA_LocationCode>JNB</IATA_LocationCode>
                    </OriginDepCriteria>
                </OriginDestCriteria>
            </FlightRequestOriginDestinationsCriteria>
        </FlightRequest>
        <PaxList>
            <Pax>
                <PaxID>ADULT_1</PaxID>
                <PTC>ADT</PTC>
            </Pax>
            <Pax>
                <PaxID>CHILD_1</PaxID>
                <PTC>CHD</PTC>
            </Pax>
            <Pax>
                <PaxID>YOUTH_1</PaxID>
                <PTC>GBE</PTC>
            </Pax>
        </PaxList>
        <ResponseParameters xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
	    <CurParameter>
		<CurCode>USD</CurCode>
	    </CurParameter>
	</ResponseParameters>
</Request>

XML Snippet

Element

Details

DataType

M/O/C

<PaxList>

Travellers in the shopping transaction.

Note: 1 to 9 paxs are supported.

<Request>
 ... 
 <PaxList>
    <Pax>
      <PaxID>ADULT_1</PaxID>
      <PTC>ADT</PTC>
    </Pax>
    <Pax>
      <PaxID>ADULT_2</PaxID>
      <PTC>ADT</PTC>
    </Pax>
    <Pax>
      <PaxID>CHILD_1</PaxID>
      <PTC>CHD</PTC>
    </Pax>
    <Pax>
      <PaxID>YOUTH_1</PaxID>
      <PTC>GBE</PTC>
    </Pax>
    <Pax>
      <PaxID>INFANT_1</PaxID>
      <PTC>INF</PTC>
    </Pax>
    <Pax>
      <PaxID>INFANT_2</PaxID>
      <PTC>INF</PTC>
    </Pax>
  </PaxList>
  ...
</Request>

Feedback for this page? How was your experience? Please click here

Page Index

Schema Data Model

Request Definition