Skip Navigation

Update Itinerary

v1.19.22
Air
Reservation
SOAP API
Travel Agency
Airline Carrier

Add Secure Flight Information

DOCS can only be added to the UpdateReservationRQ request via the SpecialServiceRequestUpdate element. This is done by specifying DOCS as the SSR and adding the full text of the SSR in the Text child element. Follow the template below:

DB/(date of birth DDMMMYY)/(gender code F,M,X, FI, MI)/(last name)/(first name)

  • Request
    <UpdateReservationRQ xmlns="http://webservices.sabre.com/pnrbuilder/v1_19" xmlns:or="http://services.sabre.com/res/or/v1_12" Version="1.19.0" EchoToken="RK/ENV/PXGSSDMLT-60703">
        <RequestType>Stateful</RequestType>
        <ReturnOptions IncludeUpdateDetails="true" RetrievePNR="true" />
        <ReservationUpdateList>
            <ReservationUpdateItem UpdateId="1">
                <SpecialServiceRequestUpdate op="C" type="H">
                    <SpecialService>
                        <Code>DOCS</Code>
                        <Text>DB/03MAR90/M/LASTNAME/NAME-01.01</Text>
                    </SpecialService>
                </SpecialServiceRequestUpdate>
            </ReservationUpdateItem>
            <ReceivedFrom>
                <AgentName>WS</AgentName>
            </ReceivedFrom>
        </ReservationUpdateList>
    </UpdateReservationRQ>
  • Response
    <stl19:UpdateReservationRS xmlns:stl19="http://webservices.sabre.com/pnrbuilder/v1_19" xmlns:ns6="http://services.sabre.com/res/orr/v0" xmlns:or114="http://services.sabre.com/res/or/v1_14" xmlns:raw="http://tds.sabre.com/itinerary" xmlns:ns4="http://webservices.sabre.com/pnrconn/ReaccSearch" Version="1.19.0">
        <stl19:Success>OK</stl19:Success>
        <stl19:Reservation numberInParty="0" numberOfInfants="0" NumberInSegment="0">
            <stl19:BookingDetails>
                <stl19:UpdateTimestamp>1899-12-31T18:00:00</stl19:UpdateTimestamp>
                <stl19:PNRSequence>0</stl19:PNRSequence>
                <stl19:FlightsRange Start="2021-05-25T06:57:00" End="2021-05-25T10:00:00"/>
                <stl19:DivideSplitDetails/>
                <stl19:UpdateToken>7e604ab0f9d762aa</stl19:UpdateToken>
            </stl19:BookingDetails>
            <stl19:POS AirExtras="false" InhibitCode="U">
                <stl19:Source BookingSource="A0A0" PseudoCityCode="xxxx" AirlineVendorID="AA" HomePseudoCityCode="xxxx" PrimeHostID="1S"/>
            </stl19:POS>
            <stl19:PassengerReservation>
                <stl19:Passengers>
                    <stl19:Passenger id="3" nameType="S" passengerType="ADT" nameId="01.01" nameAssocId="1" elementId="pnr-3.1">
                        <stl19:LastName>LASTNAME</stl19:LastName>
                        <stl19:FirstName>NAME</stl19:FirstName>
                        <stl19:SpecialRequests>
                            <stl19:APISRequest>
                                <stl19:DOCSEntry id="9" type="A">
                                    <stl19:DateOfBirth>1990-03-03</stl19:DateOfBirth>
                                    <stl19:Gender>M</stl19:Gender>
                                    <stl19:Surname>LASTNAME</stl19:Surname>
                                    <stl19:Forename>NAME</stl19:Forename>
                                    <stl19:MiddleName/>
                                    <stl19:PrimaryHolder>false</stl19:PrimaryHolder>
                                    <stl19:FreeText/>
                                    <stl19:ActionCode>HK</stl19:ActionCode>
                                    <stl19:NumberInParty>1</stl19:NumberInParty>
                                    <stl19:VendorCode>AA</stl19:VendorCode>
                                </stl19:DOCSEntry>
                            </stl19:APISRequest>
                        </stl19:SpecialRequests>
                        <stl19:Seats/>
                    </stl19:Passenger>
                </stl19:Passengers>
                <stl19:Segments>
                    <stl19:Poc>
                        <stl19:Airport>MIA</stl19:Airport>
                        <stl19:Departure>2021-05-25T06:57:00</stl19:Departure>
                    </stl19:Poc>
                    <stl19:Segment sequence="1" id="8">
                        <stl19:Air id="8" sequence="1" segmentAssociationId="3" isPast="false" DayOfWeekInd="2" CodeShare="false" SpecialMeal="false" SmokingAllowed="false" ResBookDesigCode="G">
                            <stl19:DepartureAirport>MIA</stl19:DepartureAirport>
                            <stl19:DepartureAirportCodeContext>IATA</stl19:DepartureAirportCodeContext>
                            <stl19:ArrivalAirport>JFK</stl19:ArrivalAirport>
                            <stl19:ArrivalAirportCodeContext>IATA</stl19:ArrivalAirportCodeContext>
                            <stl19:OperatingAirlineCode>AA</stl19:OperatingAirlineCode>
                            <stl19:OperatingAirlineShortName>AMERICAN AIRLINES</stl19:OperatingAirlineShortName>
                            <stl19:OperatingFlightNumber>0189</stl19:OperatingFlightNumber>
                            <stl19:EquipmentType>738</stl19:EquipmentType>
                            <stl19:MarketingAirlineCode>AA</stl19:MarketingAirlineCode>
                            <stl19:MarketingFlightNumber>0189</stl19:MarketingFlightNumber>
                            <stl19:OperatingClassOfService>G</stl19:OperatingClassOfService>
                            <stl19:MarketingClassOfService>G</stl19:MarketingClassOfService>
                            <stl19:MarriageGrp>
                                <stl19:Ind>0</stl19:Ind>
                                <stl19:Group>0</stl19:Group>
                                <stl19:Sequence>0</stl19:Sequence>
                            </stl19:MarriageGrp>
                            <stl19:Seats/>
                            <stl19:AirlineRefId>DCAA*</stl19:AirlineRefId>
                            <stl19:Eticket>true</stl19:Eticket>
                            <stl19:DepartureDateTime>2021-05-25T06:57:00</stl19:DepartureDateTime>
                            <stl19:ArrivalDateTime>2021-05-25T10:00:00</stl19:ArrivalDateTime>
                            <stl19:FlightNumber>0189</stl19:FlightNumber>
                            <stl19:ClassOfService>G</stl19:ClassOfService>
                            <stl19:ActionCode>SS</stl19:ActionCode>
                            <stl19:NumberInParty>1</stl19:NumberInParty>
                            <stl19:SegmentSpecialRequests/>
                            <stl19:inboundConnection>false</stl19:inboundConnection>
                            <stl19:outboundConnection>false</stl19:outboundConnection>
                            <stl19:ScheduleChangeIndicator>false</stl19:ScheduleChangeIndicator>
                            <stl19:Pos>
                                <stl19:IataNumber>9999999</stl19:IataNumber>
                                <stl19:AgencyCityCode>DFW</stl19:AgencyCityCode>
                                <stl19:CountryCode>US</stl19:CountryCode>
                                <stl19:DutyCode>*</stl19:DutyCode>
                            </stl19:Pos>
                            <stl19:Banner>MARKETED BY AMERICAN AIRLINES</stl19:Banner>
                            <stl19:Informational>false</stl19:Informational>
                        </stl19:Air>
                    </stl19:Segment>
                </stl19:Segments>
                <stl19:TicketingInfo/>
                <stl19:ItineraryPricing/>
            </stl19:PassengerReservation>
            <stl19:ReceivedFrom>
                <stl19:Name>P</stl19:Name>
            </stl19:ReceivedFrom>
            <stl19:EmailAddresses/>
            <stl19:OpenReservationElements>
                <or114:OpenReservationElement id="9" type="SRVC" elementId="pnr-9">
                    <or114:ServiceRequest actionCode="HK" airlineCode="AA" code="DOCS" serviceCount="1" serviceType="SSR" ssrType="AFX">
                        <or114:FreeText>/DB/03MAR90/M/LASTNAME/NAME</or114:FreeText>
                        <or114:FullText>DOCS AA HK1/DB/03MAR90/M/LASTNAME/NAME</or114:FullText>
                        <or114:TravelDocument>
                            <or114:Type>DB</or114:Type>
                            <or114:DateOfBirth>03MAR90</or114:DateOfBirth>
                            <or114:Gender>M</or114:Gender>
                            <or114:LastName>LASTNAME</or114:LastName>
                            <or114:FirstName>NAME</or114:FirstName>
                            <or114:Infant>false</or114:Infant>
                            <or114:HasDocumentData>false</or114:HasDocumentData>
                        </or114:TravelDocument>
                    </or114:ServiceRequest>
                    <or114:NameAssociation>
                        <or114:LastName>LASTNAME</or114:LastName>
                        <or114:FirstName>NAME</or114:FirstName>
                        <or114:NameRefNumber>01.01</or114:NameRefNumber>
                        <or114:ReferenceId>1</or114:ReferenceId>
                    </or114:NameAssociation>
                </or114:OpenReservationElement>
            </stl19:OpenReservationElements>
        </stl19:Reservation>
        <stl19:Results>
            <stl19:UpdateResult UpdateId="1" Status="SUCCESS">
                <stl19:Item id="9" op="C"/>
            </stl19:UpdateResult>
        </stl19:Results>
    </stl19:UpdateReservationRS>

FAQs

What is Secure Flight information?

Secure Flight is a program developed by the United States Department of Homeland Security (DHS) in response to a key 9/11 Commission recommendation; uniform watchlist matching by the Transportation Security Administration (TSA). The mission of the Secure Flight program is to enhance the security of domestic and international commercial air travel through the use of improved watchlist matching.

What is included within the Secure Flight program?

Flight information includes airlines flying into, out of, within, or over the United States, as well as all point-to-point international flights operated by U.S.-based airlines. Secure Flight applies to all applicable PNRs, regardless of the sales channel the reservation was booked through.

What does watchlist matching mean?

Secure Flight matches the name, date of birth, and gender information for each passenger against government watch lists to:

  • Identify known and suspected terrorists
  • Prevent individuals on the "No Fly List" from boarding an aircraft
  • Identify individuals on the "Selectee List" for enhanced screening
  • Facilitate passenger air travel
  • Protect individuals' privacy

What fields are mandatory when entering Secure Flight Passenger Data (SFPD)?

TSA requires airlines to collect and transmit the following Secure Flight Passenger Data (SFPD). These data elements are stored in the IATA SSR standard: DOCS. This includes:

  • Passenger full name: as it appears on state or government ID used at the airport (state ID card, driver's license or passport)
  • Date of birth: must match the data on the document presented at the airport
  • Gender

Is the passenger's middle/second name mandatory when entering SFPD?

No. The second or middle name is an optional field, unless the official document the passenger presents upon check-in at the airport contains the middle/second name.

Is a prefix/suffix considered for SFPD match?

Prefix and suffixes in the PNR name field are not used when a name match is considered. If all other information is accurate in the PNR and SFPD, these scenarios will typically pass to allow check in.

Is Secure Flight information required for all passengers?

Yes. All passengers including minors (17 and under) must provide their full name, date of birth, and gender. The data provided must match the data on the document presented at the airport.

What happens with Secure Flight information if a passenger is a minor without ID?

If the individual is "under 18 years of age and does not have a verifying identity document, TSA may, on a case-by-case basis, authorize the minor or an adult accompanying the minor to state the individual’s full name and date of birth in lieu of providing a verifying document."

Do I need to include name titles when entering SFPD?

No. Even though the PNR name field may include a title (MR, MRS, MISS, MSTR, ESQ, DR, etc.), the title should not be added to the SFPD 3DOCS entry.

What data is optional when entering SFPD?

Optional Secure Flight data elements include:

  • Redress number: Unique identifier issued by DHS to those using the Traveler Redress Inquiry Program.
  • Known Traveler Number: Unique identifier for the Pre-Screening Pilot Program to expedite security processes for certain frequent fliers members and certain members of government approved Trusted Traveler programs such as: Global Entry, NEXUS, SENTRI.

What happens if the PNR is missing SFPD?

PNRs without full SFPD will be rejected by the TSA’s Secure Flight rule and will not be processed by TSA.

Do I need to add all needed SFPD before issuing tickets?

Yes. Once you add the appropriate Secure Flight data and it is updated in the airline system, you can issue the tickets.

You are allowed to use segment select or name select to ticket those passengers with associated Secure Flight data, leaving those without data unticketed. You can ticket the remaining passengers once their SFPD is added to the PNR.

How do I include SFPD for an infant with their own (purchased) seat?

  • Because a purchased seat requires a valid name field - even for infants - do not use the infant name indicators in your SFPD SSR request
  • Use the adult gender identifier of M for Male or F for Female

Which gender codes can be included when adding SFPD to the PNR?

Acceptable gender codes include:

  • M - Male
  • F - Female
  • MI - Male Infant
  • FI - Female Infant
  • U - Undisclosed

    Note: This gender code is valid for APIS and Secure Flight (SFPD) formats only.

  • X - Unspecified

Resources