Get Real-Time Flight Schedules and Reference Ticket Price Data

We use cookies.This website uses essential cookies to operate core features. With your consent, we also use analytics cookies to understand traffic and improve the service. For more details, see our .

Flight Information Query API - Real-time Schedules & Prices | Toolkk

Response Example

{
  "reason": "成功",
  "result": {
    "orderid": "JH818250617094826CZLKl",
    "flightInfo": [
      {
        "airline": "CA",
        "airlineName": "中国**航空公司",
        "flightNo": "CA0953 | CA0916",
        "isCodeShare": false,
        "departure": "PEK",
        "departureName": "首都国际机场",
        "departureDate": "2025-06-18",
        "departureTime": "09:05",
        "arrivalDate": "2025-06-18",
        "arrivalTime": "17:05",
        "arrival": "PVG",
        "arrivalName": "浦东国际机场",
        "duration": "08h00m",
        "transferNum": 2,
        "ticketPrice": 15063,
        "segments": [
          {
            "airline": "CA",
            "flightNo": "CA0953",
            "isCodeShare": false,
            "opAirline": "CA",
            "opFlightNo": "CA0953",
            "equipment": "738",
            "departure": "PEK",
            "departureDate": "2025-06-18",
            "departureTime": "09:05",
            "arrival": "FUK",
            "arrivalDate": "2025-06-18",
            "arrivalTime": "14:10",
            "flightTime": "04h05m",
            "airlineName": "中国**航空公司",
            "departureName": "首都国际机场",
            "arrivalName": "福冈机场"
          },
          {
            "airline": "CA",
            "flightNo": "CA0916",
            "isCodeShare": false,
            "opAirline": "CA",
            "opFlightNo": "CA0916",
            "equipment": "321",
            "departure": "FUK",
            "departureDate": "2025-06-18",
            "departureTime": "15:55",
            "arrival": "PVG",
            "arrivalDate": "2025-06-18",
            "arrivalTime": "17:05",
            "flightTime": "02h10m",
            "airlineName": "中国**航空公司",
            "departureName": "福冈机场",
            "arrivalName": "浦东国际机场"
          }
        ]
      }
    ]
  },
  "error_code": 0
}

Response Fields

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

Path	Type	Sample
type	string	object
properties	object	{...}
properties.reason	object	{...}
properties.reason.type	string	string
properties.reason.example	string	成功
properties.result	object	{...}
properties.result.type	string

Shell Example

curl --request GET \
  --url 'https://openapi.toolkk.com/v1/flight-query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{}'

Python Example

import os
import requests

url = "https://openapi.toolkk.com/v1/flight-query"
payload = {}

headers = {
    "Content-Type": "application/json",
    "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}

response = requests.get(url, headers=headers, params=payload, timeout=30)
response.raise_for_status()
print(response.json())

Go Example

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/v1/flight-query"
    payload := []byte("{}")

    req, err := http.NewRequest("GET", 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))
}

Java Example

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 = "{}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/flight-query"))
            .method("GET", 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 Example

<?php

$endpoint = 'https://openapi.toolkk.com/v1/flight-query';
$payload = "{}";

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    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;

Flight Information Lookup

Documentation

API Introduction

Use Cases

Request and Response Details

Integration Recommendations

Integration Examples

Request Example