- Default module
- Flight
- Train
- 12306
- 查询与预订
- 订单
- 车次与站点
- 退改签
- 合作方同步
- 电子票
- Schemas
- ApiResponseBase
- ErrorResponse
- EmptyObject
- CabinClass
- PassengerType
- Gender
- TravelDocument
- AllianceCode
- TransportType
- RefundReason
- ChangeReason
- FlightOrderType
- FlightOrderStatus
- PaymentChannel
- ConfirmationType
- ConfirmationIata
- PassengerInfo
- FlightJourney
- PassengerCount
- AccountCode
- ShoppingRequirements
- ShoppingVirtualInterlineConfig
- ShoppingConfigs
- OpenAPIFlightShoppingReq
- PricingReqSegment
- FlightPricingReq
- AllCabinPriceReq
- SolutionValidateReq
- FareRulesReq
- CreateFlightOriginOrderRequest
- PassengerForCreateOriginOrder
- PayFlightOrderReq
- RefundChangeAvailabilityReq
- ChangeSearchReq
- ChangeSearchPassenger
- ChangeSearchJourney
- CreateChangeOrderReq
- ChangeSegmentItem
- ChangeNewSegment
- RefundMoneySearchReq
- CreateFlightRefundOrderOpenAPIRequest
- BaggageTransitReq
- BaggageTransitLeg
- BaggageTransitSegment
- BaggageTransitStopInfo
- TicketStatusReq
- TicketStatusPassenger
- DownloadAirTicketItineraryRequest
- ConfirmationSheetPrice
- OpenAPIShoppingResp
- OpenAPICoreSegment
- StopOver
- OpenAPISolutionResp
- OpenAPIPriceDetail
- OpenAPILimitInfo
- FlightLimitAgePair
- FlightSolutionGroupInfo
- OpenAPIPrice
- OpenAPITax
- OpenAPIJourneyResp
- OpenAPISegmentInfo
- OpenAPIBaggageRule
- BaggageRuleDetail
- OpenAPIBaggageRules
- OpenAPIFareRules
- OpenAPIFareRule
- OpenAPIPricingResp
- OpenAPIPricingSolutionResp
- OpenAPIPricingPriceDetail
- OpenAPIPricingPrice
- OpenAPIPricingJourneyResp
- OpenAPIPricingSegmentInfo
- OpenAPIVerificationResp
- OpenAPIFareRulesResp
- OpenAPIOrderResp
- OpenAPIOrderJourney
- OpenAPIOrderSegment
- OpenAPIOrderCoreSegment
- OpenAPIOrderPassenger
- OpenAPIOrderTicket
- OpenAPIOrderPriceDetail
- OpenAPIOrderPrice
- OpenAPIOriginOrderPrice
- OpenAPIChangeOrderPrice
- OpenAPIRefundOrderPrice
- OpenAPIOrderListResp
- OpenAPIRefundChangeAvailabilityResp
- OpenAPIRefundChangeAvailabilityPassenger
- OpenAPIAskChangeDetail
- OpenAPIAskRefundDetail
- OpenAPIChangeSearchResp
- OpenAPIChangeSolutionResp
- OpenAPIChangePriceDetail
- OpenAPIChangePrice
- OpenAPIRefundMoneySearchResp
- OpenAPIBaggageTransitLeg
- OpenAPIBaggageTransitSegmentInfo
- TicketStatusResp
- TicketStatusItem
- TicketCouponStatus
- BalanceResp
- TrainApiResponseBase
- TrainErrorResponse
- TrainConnectionRegion
- TrainPriceBasis
- TrainOrderStatus
- TrainTicketStatus
- TrainTicketType
- TrainPassengerAttribute
- LocalizedName
- TrainShoppingLocation
- TrainShoppingRequest
- TrainStationWithDateTime
- TrainCarrier
- TrainShoppingFeature
- TrainPassengerTypeInfo
- TrainSeatInfo
- TrainShoppingSegment
- TrainShoppingJourney
- TrainShoppingData
- TrainPrice
- TrainAvailabilityRequest
- TrainAvailabilityData
- TrainBookingRequirementsData
- TrainSeatPreference
- TrainOrderContactRequest
- TrainOrderContact
- TrainPassengerRequest
- Train12306Account
- TrainCreateOrderRequest
- TrainCreateChangeRequest
- TrainCreateRefundRequest
- TrainChangeEstimateRequest
- TrainRefundEstimateRequest
- TrainPassenger
- TrainOrderSegment
- TrainOrderTicket
- TrainOrderJourney
- TrainOrder
- TrainConditionFee
- TrainCondition
- TrainOrderConditions
- TrainRefundEstimateItem
- TrainRefundEstimateData
- TrainChangeEstimateItem
- TrainChangeEstimateData
- TrainStopStation
- Train12306AccountRequest
- Train12306Contact
- Train12306PayFormRequest
- Train12306PayFormData
- Train12306LoginRequest
- Train12306PassengerInfo
- Train12306LoginData
- Train12306SendSmsRequest
- Train12306SmsVerifyRequest
- Train12306SmsSendData
- Train12306OperationData
- Train12306PassengerDto
- Train12306EditPassengerRequest
- Train12306FaceImage
- Train12306FaceVideo
- Train12306FaceVerifyRequest
- Train12306ForeignPassportRequest
- Train12306PassportProcessRequest
- Train12306PassportCheckData
- TrainStationInfo
- TrainCityInfo
- TrainStationSearchCity
- TrainStationSearchData
- TrainCitiesStationsData
- TrainOrderTicketFile
- TrainSyncRequest
- TrainSyncCity
- TrainSyncStation
- TrainSyncCitiesData
- TrainSyncStationsData
- TrainShoppingApiResponse
- TrainAvailabilityApiResponse
- TrainBookingRequirementsApiResponse
- TrainOrderApiResponse
- TrainStopStationsApiResponse
- TrainConditionsApiResponse
- TrainChangeEstimateApiResponse
- TrainRefundEstimateApiResponse
- TrainEmptyApiResponse
- Train12306ContactsApiResponse
- Train12306PayFormApiResponse
- Train12306LoginApiResponse
- Train12306SmsSendApiResponse
- Train12306SmsVerifyApiResponse
- Train12306OperationApiResponse
- Train12306PassportCheckApiResponse
- TrainSyncCitiesApiResponse
- TrainSyncStationsApiResponse
- TrainTicketsApiResponse
- TrainStationSearchApiResponse
- TrainCitiesStationsApiResponse
- TrainExchangeRatesApiResponse
- ShoppingApiResponse
- PricingApiResponse
- VerificationApiResponse
- FareRulesApiResponse
- OrderApiResponse
- OrderListApiResponse
- RefundChangeAvailabilityApiResponse
- ChangeSearchApiResponse
- RefundMoneySearchApiResponse
- BaggageTransitApiResponse
- TicketStatusApiResponse
- BalanceApiResponse
查询火车票订单
GET
/train/openapi/v4/orders/{orderId}
Request
Authorization
API Key
Add parameter in header
code
Example:
code: ********************API Key
Add parameter in header
timestamp
Example:
timestamp: ********************API Key
Add parameter in header
signature
Example:
signature: ********************or
Path Params
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 '/train/openapi/v4/orders/TO202607150001' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>'Responses
🟢200
application/json
Bodyapplication/json
Example
{
"code": 0,
"message": "Success",
"data": {
"customOrderId": "EXT-TRAIN-20260715-001",
"id": "TO202607150001",
"passengers": [
{
"id": 10001,
"givenNames": "SAN",
"surname": "ZHANG",
"gender": "male",
"birthday": "1990-01-15",
"passengerType": "adult",
"travelDocumentType": "passport",
"travelDocumentNumber": "110101199001011234",
"travelDocumentExpireDate": "2030-01-15",
"nationality": "CN"
}
],
"journey": {
"id": "train_journey_G1_20260720",
"departureCode": "BJP",
"arrivalCode": "SHH",
"tripCode": "G1",
"tripType": "High speed G",
"seatClassId": "erdengzuo",
"seatClassName": "二等座",
"departureDate": "2026-07-20",
"departureTime": "09:00",
"days": 0,
"arrivalDate": "2026-07-20",
"arrivalTime": "13:28",
"duration": "PT4H28M",
"segments": [
{
"id": "segment_0",
"departureCode": "BJP",
"arrivalCode": "SHH",
"tripCode": "G1",
"tripType": "High speed G",
"seatClassId": "erdengzuo",
"seatClassName": "二等座",
"departureDate": "2026-07-20",
"departureTime": "09:00",
"days": 0,
"arrivalDate": "2026-07-20",
"arrivalTime": "13:28",
"duration": "PT4H28M"
}
],
"features": [
{
"code": "WIFI",
"name": "Wi-Fi",
"description": "车内提供无线网络"
}
],
"tickets": {
"10001": {
"carNumber": "08",
"seatNum": "12A",
"status": "issued"
}
}
},
"returnJourney": {
"id": "train_journey_G1_20260720",
"departureCode": "BJP",
"arrivalCode": "SHH",
"tripCode": "G1",
"tripType": "High speed G",
"seatClassId": "erdengzuo",
"seatClassName": "二等座",
"departureDate": "2026-07-20",
"departureTime": "09:00",
"days": 0,
"arrivalDate": "2026-07-20",
"arrivalTime": "13:28",
"duration": "PT4H28M",
"segments": [
{
"id": "segment_0",
"departureCode": "BJP",
"arrivalCode": "SHH",
"tripCode": "G1",
"tripType": "High speed G",
"seatClassId": "erdengzuo",
"seatClassName": "二等座",
"departureDate": "2026-07-20",
"departureTime": "09:00",
"days": 0,
"arrivalDate": "2026-07-20",
"arrivalTime": "13:28",
"duration": "PT4H28M"
}
],
"features": [
{
"code": "WIFI",
"name": "Wi-Fi",
"description": "车内提供无线网络"
}
],
"tickets": {
"10001": {
"carNumber": "08",
"seatNum": "12A",
"status": "issued"
}
}
},
"contact": {
"name": "ZHANG SAN",
"gender": "male",
"email": "contact@example.com",
"phoneRegion": "+86",
"phone": "13800138000",
"zipCode": "100000",
"city": "Beijing",
"streetAndNumber": "No. 1 Railway Street"
},
"status": "pre_check",
"marketingCarrier": {
"code": "CNRW",
"name": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"currency": "CNY",
"price": {
"ticketPrice": 553,
"issuedTicketPrice": 550,
"amount": 573,
"serviceFees": 20,
"refundTicketPrice": 500,
"changeRefundCost": 53,
"refundFee": 10,
"ticketPriceDiff": 3
},
"priceBasis": "passenger",
"lastError": "Supplier reservation failed"
}
}🟢200TrainBusinessError
Modified at 2026-07-21 08:28:46