Search Cities and Stations

GET

/train/openapi/v4/stations

Search cities and stations by name or code. The current implementation returns an empty array, not an error, when text is shorter than three characters.

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

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/train/openapi/v4/stations?text=sha&locale=zh-Hans&selectedDepartureCity=CNBJS&selectedDepartureStation=BJP&selectedArrivalCity=CNSHA&selectedArrivalStation=SHH' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>'

Responses

🟢200

application/json

Query completed successfully.

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Success",
    "data": {
        "cities": [
            {
                "code": "CNBJS",
                "name": {
                    "en": "Beijing South",
                    "zh-Hans": "Beijing South"
                },
                "countryCode": "CN",
                "stations": [
                    {
                        "code": "BJP",
                        "name": {
                            "en": "Beijing South",
                            "zh-Hans": "Beijing South"
                        },
                        "countryCode": "CN",
                        "connections": [
                            "CNSHA"
                        ],
                        "blocked": false
                    }
                ],
                "blocked": false,
                "connections": [
                    "CNSHA"
                ]
            }
        ]
    }
}

🟢200TrainBusinessError

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

Get Stop Stations by Train Number

Get Cities and Stations in Bulk