ChinaTicket.Online OPEN API Document
  1. flight
ChinaTicket.Online OPEN API Document
  • Open API
    • flight
      • Flight Shopping
        POST
      • Flight Pricing
        POST
      • Price validation
        POST
      • Create origin order
        POST
      • pay an order
        POST
      • cancel an order
        DELETE
      • order detail
        GET
      • search change solutions
        POST
      • request an flight change
        POST
      • request an refund
        POST
      • confirm to refund the tiekct
        POST
    • train
      • Train Stations
      • Train shopping
      • Create train order
      • Order detail
      • Cancel an order
      • Pay an order
      • Intercept an order
      • Refund an order
    • Get Balance
      GET
  • Schemas
    • request
      • request.FlightShoppingRequest
      • request.PayFlightOrderRequest
      • request.ChangeFlightOrderRequests
      • request.CreateFlightOriginOrderRequest
      • request.FlightChangeSearchRequest
      • request.RefundFlightOrderRequest
    • consts
      • consts.CabinClass
      • consts.RefundReason
      • consts.FlightOrderStatus
      • consts.FlightOrderType
      • consts.FlightTicketStatus
      • consts.FlightProductType
      • consts.FlightInvoiceType
      • consts.FlightTaxType
      • consts.PassengerEligibility
    • model
      • model.FlightJourneyCore
      • model.PassengerCountRequest
      • model.ChangeSegment
      • model.PassengerFlightOrder
      • model.ChangeShoppingResult
      • model.ChangeShoppingSegment
      • model.FlightSegmentInfo
      • model.BaggageRule
      • model.BaggageRuleDetail
      • model.FlightCoreSegmentCache
      • model.StopOver
      • model.OrderDetail
      • model.FareRule
      • model.FlightJourney
      • model.FlightSegmentWithCoreSegment
      • model.CoreSegmentDetail
      • model.FlightScheduleChange
      • model.FlightPassengerTickets
      • model.FlightTicket
      • model.PriceDetail
      • model.PriceInFlightOriginOrder
      • model.PriceInFlightChangeOrder
      • model.PriceInFlightRefundOrder
      • model.PriceInFlightVoidOrder
      • model.FlightSolutionResp
      • model.FlightJourneyResp
      • model.FlightPriceDetail
      • model.FlightPrice
      • model.FlightTax
      • model.FlightSolutionLimitation
      • model.FlightLimitAgePair
    • Schemas
      • consts.PassengerType
      • consts.Gender
      • consts.TrainIssueWay
      • consts.TravelDocumentType
      • consts.TrainOrderStatus
      • consts.TrainOrderTicketStatus
      • consts.TrainPassengerStatus
      • consts.TrainRefundStatus
      • dto.PaginationList-array_resp_TrainOrderResp
      • resp.TrainOrderResp
      • resp.TrainOriginTicketDetail
      • req.TrainOrderListReq
      • response.Response-dto_PaginationList-array_resp_TrainOrderResp
      • model.CreateTrainOriginOrderReq
      • response.Response-resp_TrainOrderResp
      • resp.TrainChangeDetail
      • resp.TrainChangeTicketDetail
      • resp.StationDetail
      • model.ShoppingCNTrainStationsResp
      • req.TrainShoppingReq
      • response.Response-array_model_ShoppingCNTrainStationsResp
      • resp.Seats
      • resp.StationInfo
      • response.Response-array_resp_TrainShoppingResp
      • resp.TrainShoppingResp
  1. flight

Flight Shopping

POST
/api/v2/flight/shopping
To get prices from multiple airlines and vendors for a certain trip

Request

Body Params application/json

Example
{
    "cabinClass": "economy",
    "excludeAirlines": [
        "CA",
        "UA"
    ],
    "includeAirlines": [
        "LX",
        "CZ"
    ],
    "journeys": [
        {
            "date": "2025-01-01",
            "departureDate": "2025-01-01",
            "destination": "BKK",
            "origin": "BJS"
        }
    ],
    "maxDuration": 150,
    "maxPrice": 8899,
    "maxSegments": 0,
    "mustHaveBag": false,
    "passengers": {
        "adult": 0,
        "child": 0,
        "infant": 0
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v2/flight/shopping' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cabinClass": "economy",
    "excludeAirlines": [
        "CA",
        "UA"
    ],
    "includeAirlines": [
        "LX",
        "CZ"
    ],
    "journeys": [
        {
            "date": "2025-01-01",
            "departureDate": "2025-01-01",
            "destination": "BKK",
            "origin": "BJS"
        }
    ],
    "maxDuration": 150,
    "maxPrice": 8899,
    "maxSegments": 0,
    "mustHaveBag": false,
    "passengers": {
        "adult": 0,
        "child": 0,
        "infant": 0
    }
}'

Responses

🟢200OK
application/json
OK
Body

Example
Modified at 2025-03-18 06:10:58
Previous
flight
Next
Flight Pricing
Built with