TravelCaster API - Flights - Samples

Back to Flights home.


Download Samples

Download Postman Collection with full request/response data for JSON version.

GetFlightAvailability

Round-trip flight availability, from Buenos Aires to Santiago, travelling on July 1st, returning on July 8th, for 1 adult, search only on LATAM Airlines flights.

Request

<FlightAvailabilityQuery>
  <Token>1234567890123456</Token>
  <Legs>
    <QueryLeg>
      <DepartureAirportCity>BUE</DepartureAirportCity>
      <ArrivalAirportCity>SCL</ArrivalAirportCity>
      <FlightDate>2013-07-01</FlightDate>
    </QueryLeg>
    <QueryLeg>
      <DepartureAirportCity>SCL</DepartureAirportCity>
      <ArrivalAirportCity>BUE</ArrivalAirportCity>
      <FlightDate>2013-07-08</FlightDate>
    </QueryLeg>
  </Legs>
  <Passengers>
    <PaxOption><Type>ADT</Type><Count>1</Count></PaxOption>
  </Passengers>
  <Airlines><string>LA</string></Airlines>
</FlightAvailabilityQuery>

Response

<FlightRecommendation>
  <Token>788de2e2b1703b8c</Token>
  <TransactionID>d36d1a6556c3d716</TransactionID>
  <TransactionCode>0</TransactionCode>
  <RecommendationID>64cb00748c23a18f</RecommendationID>
  <CacheID>4E91531CF67FC58BB1F6F850BCE4788A</CacheID>
  <Fares>
    <FlightFare>
      <FareID>d16e413ff60aa18f</FareID>
      <FareAmount>165</FareAmount>
      <TaxAmount>133.12</TaxAmount>
      <ServiceAmount>0</ServiceAmount>
      <PaxFares>
        <PaxFare>
          <PaxFareAmount>165</PaxFareAmount>
          <PaxTaxAmount>133.12</PaxTaxAmount>
          <PaxType>ADT</PaxType>
          <Count>1</Count>
        </PaxFare>
      </PaxFares>
      <Currency>USD</Currency>
      <LastTicketingDate>2013-05-14T22:59:00.000Z</LastTicketingDate>
      <ValidatingCarrier>LA</ValidatingCarrier>
      <Legs>
        <FlightLeg>
          <LegNumber>1</LegNumber>
          <Options>
            <FlightOption>
              <FlightOptionID>b3391e197fc77a7d</FlightOptionID>
              <OptionDuration>160</OptionDuration>
              <Segments>
                <FlightSegment>
                  <SegmentNumber>1</SegmentNumber>
                  <Airline>LA</Airline>
                  <FlightNumber>2427</FlightNumber>
                  <BookingClass>X</BookingClass>
                  <Departure>
                    <AirportCode>EZE</AirportCode>
                    <Date>2013-07-01</Date>
                    <Time>07:20</Time>
                  </Departure>
                  <Arrival>
                    <AirportCode>SCL</AirportCode>
                    <Date>2013-07-01</Date>
                    <Time>08:40</Time>
                  </Arrival>
                  <Stops/>
                  <Status>NN</Status>
                </FlightSegment>
              </Segments>
            </FlightOption>
            <FlightOption>
            ...
            </FlightOption>
          </Options>
        </FlightLeg>
        <FlightLeg>
          <LegNumber>2</LegNumber>
          <Options>
            <FlightOption>
              <FlightOptionID>7dfe0995e3f7a7d</FlightOptionID>
            ...
            </FlightOption>
          </Options>
        </FlightLeg>
      </Legs>
    </FlightFare>
  </Fares>
</FlightRecommendation>

ConfirmFlightAvailability

Two-leg flight confirmation, based on previously retrieved flight availability.

Request

<FlightAvailabilityConfirmation>
  <Token>1234657890123456</Token>
  <RecommendationID>745b4623297da79b</RecommendationID>
  <FareID>298aa5ec8f84a79b</FareID>
  <OptionID>
    <string>3cc8be673961a79b</string>
    <string>420a33980611af9b</string>
  </OptionID>
</FlightAvailabilityConfirmation>

Response

<FlightBookingRequest>
  <Token>8f905eeb3cbc82bb</Token>
  <TransactionID>d0634fe3f9bee9b9</TransactionID>
  <RecommendationID>745b4623297da79b</RecommendationID>
  <BookingFare>
    <FareID>298aa5ec8f84a79b</FareID>
    <FareAmount>227</FareAmount>
    <TaxAmount>243.92</TaxAmount>
    <ServiceAmount>0</ServiceAmount>
    <PaxFares>
      <PaxFare>
        <PaxFareAmount>227</PaxFareAmount>
        <PaxTaxAmount>243.92</PaxTaxAmount>
        <PaxType>ADT</PaxType>
        <Count>1</Count>
      </PaxFare>
    </PaxFares>
    <Currency>USD</Currency>
    <LastTicketingDate>2013-05-21T22:59:00.000Z</LastTicketingDate>
    <ValidatingCarrier>AC</ValidatingCarrier>
    <Legs>
      <FlightLeg>
        <LegNumber>1</LegNumber>
        <Options>
          <FlightOption>
            <FlightOptionID>3cc8be673961a79b</FlightOptionID>
            <OptionDuration>160</OptionDuration>
            <Segments>
              <FlightSegment>
                <SegmentNumber>490</SegmentNumber>
                <Airline>AC</Airline>
                <FlightNumber>93</FlightNumber>
                <BookingClass>T</BookingClass>
                <Departure>
                  <AirportCode>EZE</AirportCode>
                  <Date>2013-07-01</Date>
                  <Time>16:00</Time>
                </Departure>
                <Arrival>
                  <AirportCode>SCL</AirportCode>
                  <Date>2013-07-01</Date>
                  <Time>17:20</Time>
                </Arrival>
                <Stops/>
                <Status>NN</Status>
              </FlightSegment>
            </Segments>
          </FlightOption>
        </Options>
      </FlightLeg>
      <FlightLeg>
        <LegNumber>2</LegNumber>
        <Options>
          <FlightOption>
            <FlightOptionID>420a33980611af9b</FlightOptionID>
            <OptionDuration>140</OptionDuration>
            <Segments>
              <FlightSegment>
                <SegmentNumber>492</SegmentNumber>
                <Airline>AC</Airline>
                <FlightNumber>92</FlightNumber>
                <BookingClass>V</BookingClass>
                <Departure>
                  <AirportCode>SCL</AirportCode>
                  <Date>2013-07-08</Date>
                  <Time>10:20</Time>
                </Departure>
                <Arrival>
                  <AirportCode>EZE</AirportCode>
                  <Date>2013-07-08</Date>
                  <Time>13:20</Time>
                </Arrival>
                <Stops/>
                <Status>NN</Status>
              </FlightSegment>
            </Segments>
          </FlightOption>
        </Options>
      </FlightLeg>
    </Legs>
  </BookingFare>
  <Passengers>
    <PaxInformation>
      <Type>ADT</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>1</Number>
      [<RequiredInformations>]
        <AdditionalBookingInformation>
          <FieldName>NATL</FieldName>
          <FieldValue/>
        </AdditionalBookingInformation>
      [</RequiredInformations>]
    </PaxInformation>
  </Passengers>
  [<AllowedCardPayments>]
    <AllowedCardPayment>
      <CardType>AX</CardType>
      <Description>Promo AMEX</Description>
      <Installments>3,6</Installments>
      <LimitBIN>374741,374742,374743</LimitBIN>
      <Surcharge>0</Surcharge>
      <AuthRequirementType/>
    </AllowedCardPayment>
    <AllowedCardPayment>
      <CardType>VI</CardType>
      <Description>Visa Banco Santander - 18 cuotas</Description>
      <Installments>18</Installments>
      <LimitBIN>451995</LimitBIN>
      <Surcharge>192.51</Surcharge>
      <AuthRequirementType/>
    </AllowedCardPayment>
    <AllowedCardPayment>
      <CardType>CA</CardType>
      <Description>Promo MasterCard Viajes</Description>
      <Installments>3,6,9,12</Installments>
      <LimitBIN/>
      <Surcharge>0</Surcharge>
      <AuthRequirementType/>
    </AllowedCardPayment>
  [</AllowedCardPayments>]
</FlightBookingRequest>

BookFlight

Four passengers (2 adults, 1 child, 1 infant) in a one-way flight from Sao Paulo to New York, on LATAM Airlines.

In this example, API access requires credit card information.

Request

<FlightBookingRequest>
  <Token>1234567890123456</Token>
  <TransactionID>2d5f17c07a24e44b</TransactionID>
  <RecommendationID>fe8300113ad30f43</RecommendationID>
  <BookingFare>
    <FareID>cf41978d06bf8643</FareID>
    <FareAmount>1662</FareAmount>
    <TaxAmount>731.84</TaxAmount>
    <ServiceAmount>0</ServiceAmount>
    <PaxFares>
      <PaxFare>
        <PaxFareAmount>520</PaxFareAmount>
        <PaxTaxAmount>232.96</PaxTaxAmount>
        <PaxType>ADT</PaxType>
        <Count>2</Count>
      </PaxFare>
      <PaxFare>
        <PaxFareAmount>520</PaxFareAmount>
        <PaxTaxAmount>232.96</PaxTaxAmount>
        <PaxType>CHD</PaxType>
        <Count>1</Count>
      </PaxFare>
      <PaxFare>
        <PaxFareAmount>102</PaxFareAmount>
        <PaxTaxAmount>32.96</PaxTaxAmount>
        <PaxType>INF</PaxType>
        <Count>1</Count>
      </PaxFare>
    </PaxFares>
    <Currency>USD</Currency>
    <LastTicketingDate>2013-05-12T22:59:00.000Z</LastTicketingDate>
    <ValidatingCarrier>LA</ValidatingCarrier>
    <Legs>
      <FlightLeg>
        <LegNumber>1</LegNumber>
        <Options>
          <FlightOption>
            <FlightOptionID>8ee7e59156963203</FlightOptionID>
            <OptionDuration>570</OptionDuration>
            <Segments>
              <FlightSegment>
                <SegmentNumber>1</SegmentNumber>
                <Airline>LA</Airline>
                <FlightNumber>8080</FlightNumber>
                <BookingClass>W</BookingClass>
                <Departure>
                  <AirportCode>GRU</AirportCode>
                  <Date>2013-06-06</Date>
                  <Time>22:30</Time>
                </Departure>
                <Arrival>
                  <AirportCode>JFK</AirportCode>
                  <Date>2013-06-07</Date>
                  <Time>07:00</Time>
                </Arrival>
                <Stops/>
                <Status>NN</Status>
              </FlightSegment>
            </Segments>
          </FlightOption>
        </Options>
      </FlightLeg>
      <FlightLeg>
        <LegNumber>2</LegNumber>
        <Options>
          <FlightOption>
            <FlightOptionID>32cd9ff476a48603</FlightOptionID>
            <OptionDuration>570</OptionDuration>
            <Segments>
              <FlightSegment>
                <SegmentNumber>4</SegmentNumber>
                <Airline>LA</Airline>
                <FlightNumber>8085</FlightNumber>
                <BookingClass>S</BookingClass>
                <Departure>
                  <AirportCode>JFK</AirportCode>
                  <Date>2013-06-23</Date>
                  <Time>10:25</Time>
                </Departure>
                <Arrival>
                  <AirportCode>GIG</AirportCode>
                  <Date>2013-06-23</Date>
                  <Time>21:12</Time>
                </Arrival>
                <Stops/>
                <Status>NN</Status>
              </FlightSegment>
            </Segments>
          </FlightOption>
        </Options>
      </FlightLeg>
    </Legs>
  </BookingFare>
  <Passengers>
    <PaxInformation>
      <Type>ADT</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>1</Number>
      <FirstName>JOHN</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>1980-06-23</DateOfBirth>
      <Gender>MR</Gender>
      <RequiredInformations>
        <AdditionalBookingInformation>
          <FieldName>NATL</FieldName>
          <FieldValue>USA</FieldValue>
        </AdditionalBookingInformation>
      </RequiredInformations>
    </PaxInformation>
    <PaxInformation>
      <Type>ADT</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>2</Number>
      <FirstName>JANE</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>1975-02-18</DateOfBirth>
      <Gender>MRS</Gender>
      <RequiredInformations>
        <AdditionalBookingInformation>
          <FieldName>NATL</FieldName>
          <FieldValue>CAN</FieldValue>
        </AdditionalBookingInformation>
      </RequiredInformations>
    </PaxInformation>
    <PaxInformation>
      <Type>CHD</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>3</Number>
      <FirstName>DOROTHY</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>2005-09-01</DateOfBirth>
      <Gender>MS</Gender>
      <RequiredInformations>
        <AdditionalBookingInformation>
          <FieldName>NATL</FieldName>
          <FieldValue>USA</FieldValue>
        </AdditionalBookingInformation>
      </RequiredInformations>
    </PaxInformation>
    <PaxInformation>
      <Type>INF</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>4</Number>
      <FirstName>MICHAEL</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>2013-01-31</DateOfBirth>
      <Gender>MR</Gender>
      <RequiredInformations>
        <AdditionalBookingInformation>
          <FieldName>NATL</FieldName>
          <FieldValue>USA</FieldValue>
        </AdditionalBookingInformation>
      </RequiredInformations>
    </PaxInformation>
  </Passengers>
  <Buyer>
    <FirstName>JOHN</FirstName>
    <LastName>DOE</LastName>
    <Telephone>45231646</Telephone>
    <TelephoneArea>11</TelephoneArea>
    <TelephoneCountry>54</TelephoneCountry>
    <Email>JOHNDOE@GMAIL.COM</Email>
    <City>BUENOS AIRES</City>
  </Buyer>
  <CreditCardInfo>
    <NameOnCard>JOHN DOE</NameOnCard>
    <CardNumber>1234123412341234</CardNumber>
    <ExpirationDate>2015-01</ExpirationDate>
    <CardType>VI</CardType>
  </CreditCardInfo>
</FlightBookingRequest>

Response

<FlightBookingResponse>
  <Token>1234567890123456</Token>
  <TransactionID>2d5f17c07a24e44b</TransactionID>
  <BookingNumber>A1B2C3</BookingNumber>
  <BookingFare>
    <FareID>cf41978d06bf8643</FareID>
    <FareAmount>1662</FareAmount>
    <TaxAmount>731.84</TaxAmount>
    <ServiceAmount>0</ServiceAmount>
    <PaxFares>
      <PaxFare>
        <PaxFareAmount>520</PaxFareAmount>
        <PaxTaxAmount>232.96</PaxTaxAmount>
        <PaxType>ADT</PaxType>
        <Count>2</Count>
      </PaxFare>
      <PaxFare>
        <PaxFareAmount>520</PaxFareAmount>
        <PaxTaxAmount>232.96</PaxTaxAmount>
        <PaxType>CHD</PaxType>
        <Count>1</Count>
      </PaxFare>
      <PaxFare>
        <PaxFareAmount>102</PaxFareAmount>
        <PaxTaxAmount>32.96</PaxTaxAmount>
        <PaxType>INF</PaxType>
        <Count>1</Count>
      </PaxFare>
    </PaxFares>
    <Currency>USD</Currency>
    <LastTicketingDate>2013-05-12T22:59:00.000Z</LastTicketingDate>
    <ValidatingCarrier>LA</ValidatingCarrier>
    <Legs>
      <FlightLeg>
        <LegNumber>1</LegNumber>
        <Options>
          <FlightOption>
            <FlightOptionID>8ee7e59156963203</FlightOptionID>
            <OptionDuration>570</OptionDuration>
            <Segments>
              <FlightSegment>
                <SegmentNumber>1</SegmentNumber>
                <Airline>LA</Airline>
                <FlightNumber>8080</FlightNumber>
                <BookingClass>W</BookingClass>
                <Departure>
                  <AirportCode>GRU</AirportCode>
                  <Date>2013-06-06</Date>
                  <Time>22:30</Time>
                </Departure>
                <Arrival>
                  <AirportCode>JFK</AirportCode>
                  <Date>2013-06-07</Date>
                  <Time>07:00</Time>
                </Arrival>
                <Stops/>
                <Status>NN</Status>
              </FlightSegment>
            </Segments>
          </FlightOption>
        </Options>
      </FlightLeg>
      <FlightLeg>
        <LegNumber>2</LegNumber>
        <Options>
          <FlightOption>
            <FlightOptionID>32cd9ff476a48603</FlightOptionID>
            <OptionDuration>570</OptionDuration>
            <Segments>
              <FlightSegment>
                <SegmentNumber>4</SegmentNumber>
                <Airline>LA</Airline>
                <FlightNumber>8085</FlightNumber>
                <BookingClass>S</BookingClass>
                <Departure>
                  <AirportCode>JFK</AirportCode>
                  <Date>2013-06-23</Date>
                  <Time>10:25</Time>
                </Departure>
                <Arrival>
                  <AirportCode>GIG</AirportCode>
                  <Date>2013-06-23</Date>
                  <Time>21:12</Time>
                </Arrival>
                <Stops/>
                <Status>NN</Status>
              </FlightSegment>
            </Segments>
          </FlightOption>
        </Options>
      </FlightLeg>
    </Legs>
  </BookingFare>
  <Passengers>
    <PaxInformation>
      <Type>ADT</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>1</Number>
      <FirstName>JOHN</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>1980-06-23</DateOfBirth>
      <Gender>MR</Gender>
    </PaxInformation>
    <PaxInformation>
      <Type>ADT</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>2</Number>
      <FirstName>JANE</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>1975-02-18</DateOfBirth>
      <Gender>MRS</Gender>
    </PaxInformation>
    <PaxInformation>
      <Type>CHD</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>3</Number>
      <FirstName>DOROTHY</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>2005-09-01</DateOfBirth>
      <Gender>MS</Gender>
    </PaxInformation>
    <PaxInformation>
      <Type>INF</Type>
      <Count>0</Count>
      <Age>0</Age>
      <Number>4</Number>
      <FirstName>MICHAEL</FirstName>
      <LastName>DOE</LastName>
      <DateOfBirth>2013-01-31</DateOfBirth>
      <Gender>MR</Gender>
    </PaxInformation>
  </Passengers>
</FlightBookingResponse>

Back to Flights home.


See change history for this file
Loading...