GETPublicflight-query

Flight Information Lookup

Search for flight information and check flight status by entering your departure city, destination, and travel date.

Documentation

Search for flight information and check flight status by entering your departure city, destination, and travel date.

Integration Examples

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

Shell ExamplePython ExampleGo ExampleJava ExamplePHP Example

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;

Request Example

{}

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
}

Request Fields

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

Path	Type	Sample
type	string	object
properties	object	{...}

Response Fields