Historical On-Time Performance

Appsecurity: ${appsecurity}

With a vision of "living on time" , a global leading aviation data intelligence company

The VariFlight DataWorks Historical On-Time Performance API provides historical punctuality and delay statistics for a flight number and route. Documented fields include departure and arrival delay categories, cancellation percentage, average delay time and the delay status of the last seven flights.

Appid: ${appid}

Create time: 2026-10-22

https://dataworks.variflight.com Email: dataworks@variflight.com

Introduction

This document describes the VariFlight Historical On-Time Performance API, including authentication, request parameters, response fields, JSON examples and error responses. The interface uses UTF-8 encoding.

Authentication

The interface uses both token and IP for concurrent verification.

Token generation algorithm (MD5)

Registration code: Please obtain the registration code from the administrator of VariFlight. It is necessary for verification during the request process by both parties. Please be careful not to disclose it to the public.

Example (PHP):

<?php
function generateToken(array $data, string $appsecurity): string {
    unset($data['token']);
    ksort($data, SORT_STRING);
    $pairs = [];
    foreach ($data as $key => $value) {
        $pairs[] = $key . '=' . $value;
    }
    $str = implode('&', $pairs);
    return hash('md5', hash('md5', $str . $appsecurity));
}
// 参数值使用 UTF-8 原文;通过 token 参数传入结果,构建 URL 时再编码。
// $data['token'] = generateToken($data, $appsecurity);
// $query = http_build_query($data, '', '&', PHP_QUERY_RFC3986);

Example (Java):

import java.nio.charset.StandardCharsets;
import java.util.Map;
import java.util.stream.Collectors;
import java.security.MessageDigest;
import java.util.HexFormat;

public class TokenExample {
    public static String generateToken(
            Map<String, String> data, String appsecurity) throws Exception {
        String str = data.entrySet().stream()
            .filter(entry -> !"token".equals(entry.getKey()))
            .sorted(Map.Entry.comparingByKey())
            .map(entry -> entry.getKey() + "=" + entry.getValue())
            .collect(Collectors.joining("&"));
        return digestHex(digestHex(str + appsecurity));
    }

    private static String digestHex(String value) throws Exception {
        byte[] bytes = MessageDigest.getInstance("MD5")
            .digest(value.getBytes(StandardCharsets.UTF_8));
        return HexFormat.of().formatHex(bytes);
    }
}
// 请求 URL 追加 "&token=" + URLEncoder.encode(token, StandardCharsets.UTF_8)。

Example (C#):

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Security.Cryptography;

public static class TokenExample {
    public static string GenerateToken(
            Dictionary<string, string> data, string appsecurity) {
        string str = string.Join("&", data
            .Where(entry => entry.Key != "token")
            .OrderBy(entry => entry.Key, StringComparer.Ordinal)
            .Select(entry => entry.Key + "=" + entry.Value));
        return DigestHex(DigestHex(str + appsecurity));
    }

    private static string DigestHex(string value) {
        using (var digest = MD5.Create()) {
            byte[] result = digest.ComputeHash(Encoding.UTF8.GetBytes(value));
            return BitConverter.ToString(result).Replace("-", "").ToLowerInvariant();
        }
    }
}
// 请求 URL 追加 "&token=" + Uri.EscapeDataString(token)。

Query by Flight Number + Route:

Request URL:

https://open-al.variflight.com/api/delay?appid=${appid}&arr=PEK&dep=HFE&fnum=CA1844&lang=en&token=${token}

The parameter part in the URL is:

appid=${appid}&arr=PEK&dep=HFE&fnum=CA1844&lang=en&token=${token}

Generating the encrypted string:

str = appid=${appid}&arr=PEK&dep=HFE&fnum=CA1844&lang=en

Step2. The registration code is '${appsecurity}'. Assign this value to the variable $appsecurity.

Append appsecurity (the registration code) directly to str, with no extra separator.
Apply MD5 twice. Each result is a 32-character lowercase hexadecimal string. The second digest takes the UTF-8 bytes of the first Hex string, not its raw digest bytes.

token = md5Hex(md5Hex(str + appsecurity))

Note: $appsecurity=Registration code

API Endpoints

The request URL:

https://open-al.variflight.com/api/delay?

The way to request: GET

The format of return: json

Request parameter Details

Historical On-Time Performance employs an authorized authentication interface. At the beginning of the cooperation, VariFlight will apply on behalf of the third party to allocate user identification codes and registration codes (i.e., appid and appsecurity).

1 Response 1

Inquiry Method: 1: Query by Flight Number + Route

Request parameter Description Example Required or Optional Parameter
Type
appid App ID Yes string
lang Optional. Defaults to Chinese; returns English when set to "en". en No string
fnum Flight Number CA1844 Yes string
dep Departure Airport IATA Code HFE Yes string
arr Arrival Airport IATA Code PEK Yes string
token 32-bit API Signature Yes string

Return Parameter Details

Request parameter Description Example Parameter
Type
Delay_Dep Departure Airport IATA Code HFE string
Delay_Arr Arrival Airport IATA Code PEK string
Delay_Num Flight Number CA1844 string
Delay_None Historical Arrival On-Time Rate 96.67% string
Delay_Half Arrival Delay Within 30 Minutes Percentage 3.33% string
Delay_Hour Arrival Delay 30 Minutes to 1 Hour Percentage 0.00% string
Delay_Hours Arrival Delay Over 1 Hour Percentage 0.00% string
DepDelay_None Historical Departure On-Time Rate 96.67% string
DepDelay_Half Departure Delay Within 30 Minutes Percentage 3.33% string
DepDelay_Hour Departure Delay 30 Minutes to 1 Hour Percentage 0.00% string
DepDelay_Hours Departure Delay Over 1 Hour Percentage 0.00% string
Delay_Cancel Cancellation Percentage 1.86% string
depavdelaytime a negative value indicates early 6 number
averagedelaytime a negative value indicates early -17 number
LastSevenTrips Last 7 Flights Delay Status array
Date Flight Scheduled Departure Date 2023-02-07 string
DepDelayMin Departure Delay Minutes -55 string
ArrDelayMin Arrival Delay Minutes 2.3166666666667 string

Return Parameter Examples

Example 1: Failed return

{
  "error_code": 3,
  "error": "Lack of parameters or parameter identification failed"
}

Example 2: Successful return

{
  "Delay_Dep" : "HFE",
  "Delay_Arr" : "PEK",
  "Delay_Num" : "CA1844",
  "Delay_None" : "96.67%",
  "Delay_Half" : "3.33%",
  "Delay_Hour" : "0.00%",
  "Delay_Hours" : "0.00%",
  "DepDelay_None" : "96.67%",
  "DepDelay_Half" : "3.33%",
  "DepDelay_Hour" : "0.00%",
  "DepDelay_Hours" : "0.00%",
  "Delay_Cancel" : "1.86%",
  "depavdelaytime" : 6,
  "averagedelaytime" : -17,
  "LastSevenTrips" : [ {
    "Date" : "2023-02-07",
    "DepDelayMin" : "-55",
    "ArrDelayMin" : "2.3166666666667"
  } ]
}

Error Responses

Return parameter Description Trigger Scene Suggestions
0 No data permissions
2 The visiting ip have not been joined in white list
3 This request method has no permission temporarily
3 Lack of parameters or parameter identification failed
3 wrong flight number format
3 wrong departure airport format
3 wrong arrival airport format
10 No data
4 The current interface is expired
4 The current interface is closed
4 No data permissions
1 Pending review
11 Unknown error
0 Invalid user