Search Trains

POST

/train/openapi/v4/shopping

Search train and other surface-transport options by origin, destination, and date. Each location must provide at least one of cityId or stationCodes.

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: ********************

Body Params application/jsonRequired

Example

{
    "changeForOrderId": "TO202607150001",
    "departure": {
        "cityId": "CNBJS",
        "stationCodes": [
            "BJP"
        ]
    },
    "arrival": {
        "cityId": "CNBJS",
        "stationCodes": [
            "BJP"
        ]
    },
    "departureDate": "2026-07-20",
    "departureStartTime": "08:00",
    "departureEndTime": "18:00",
    "returnDate": "2026-07-25",
    "returnStartTime": "09:00",
    "returnEndTime": "20:00",
    "locale": "zh-Hans",
    "connectionRegion": "EUROPE"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/train/openapi/v4/shopping' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "changeForOrderId": "TO202607150001",
    "departure": {
        "cityId": "CNBJS",
        "stationCodes": [
            "BJP"
        ]
    },
    "arrival": {
        "cityId": "CNBJS",
        "stationCodes": [
            "BJP"
        ]
    },
    "departureDate": "2026-07-20",
    "departureStartTime": "08:00",
    "departureEndTime": "18:00",
    "returnDate": "2026-07-25",
    "returnStartTime": "09:00",
    "returnEndTime": "20:00",
    "locale": "zh-Hans",
    "connectionRegion": "EUROPE"
}'

Responses

🟢200

application/json

Search completed. Business errors also use HTTP 200; inspect the response code.

Bodyapplication/json

Example

🟢200TrainBusinessError

Modified at 2026-07-21 08:28:13

Query Flight Account Balance

Check Seat Availability and Price