POSTPublictrain-schedule-query

Train Schedule and Ticket Availability Query

Query nationwide train numbers, departure/arrival times, seat prices, and real-time ticket availability snapshots based on origin, destination, and travel date. Ideal for travel planning and ticket information display.

Documentation

API Capabilities

This API provides a nationwide train schedule and ticket availability query service. Users input origin station, destination station, and a specified date to retrieve a list of matching train numbers, departure and arrival times, travel duration, and price and availability snapshot information for various seat types (e.g., Second Class, First Class).

Request and Response

Request Parameters: Requires start (origin station), end (destination station), date (travel date, format YYYY-MM-DD), and an optional ishigh parameter to filter for high-speed rail (G/D trains) only.
Response Results: Returns a list of train information. Each record includes trainno (train number), departuretime (departure time), arrivaltime (arrival time), price (price for each seat type), and num (ticket quantity/status for each seat type).

Use Cases

Travel Planning Applications: Integrate into travel, calendar, or itinerary management tools to provide users with convenient train schedule queries.
Ticket Information Display: Used in corporate travel systems or local lifestyle service platforms to display train schedules and approximate ticket availability.
Data Analysis Support: Provides foundational timetable data for traffic flow analysis and popular route research.

Usage Instructions and Limitations

The ticket availability and price information returned by the API is a reference snapshot at the time of query. Due to rapid real-time changes in ticketing data, absolute consistency with actual purchase times cannot be guaranteed.
This API only provides information queries and does not support ticket purchase, modification, or refund functions.
For actual train cancellations, delays, fare adjustments, and final ticket purchase results, please always refer to the official 12306 website and real-time station announcements.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "start": "北京南",
  "end": "上海虹桥",
  "ishigh": "1",
  "date": "2026-07-20"
}

Response Example

{
  "code": 200,
  "msg": "成功",
  "taskNo": "example",
  "data": {
    "date": "2026-07-20",
    "start": "北京南",
    "end": "上海虹桥",
    "list": [
      {
        "trainno": "G1",
        "departuretime": "07:00",
        "arrivaltime": "11:30",
        "ze": {
          "price": "553.0",
          "num": "有"
        }
      }
    ]
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
start	string	北京南
end	string	上海虹桥
ishigh	string	1
date	string	2026-07-20

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	number	200
msg	string	成功
taskNo	string	example
data	object	{...}
data.date	string	2026-07-20
data.start	string	北京南
data.end	string	上海虹桥

curl --request POST \ --url 'https://openapi.toolkk.com/v1/train-schedule-query' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "start": "北京南",\n "end": "上海虹桥",\n "ishigh": "1",\n "date": "2026-07-20"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/train-schedule-query" payload = { "start": "北京南", "end": "上海虹桥", "ishigh": "1", "date": "2026-07-20" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/train-schedule-query" payload := []byte("{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/train-schedule-query")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/train-schedule-query'; $payload = "{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

Train Schedule and Ticket Availability Query

Documentation

API Capabilities

Request and Response

Use Cases

Usage Instructions and Limitations

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online