This site uses cookies to personalise content, adverts, and to analyse traffic. I'm ok with that Learn More

Documents API Documentation

This is the documentation to access the Documents API, available exclusively to Aviation Flights Business accounts. It returns information about each uploaded document for aircraft in the database.

The API Platform is only available via a REST API, in which you have to let your application grab a URL with parameters and it returns all output in either JSON format. This makes it easy to grab the data using any Programming Language of your choice.

The root URL for the API is:

GET https://aviation.flights/api/documents

Rate Limits

For the longest time it didn't need to be done but as of February 4, 2025 there is now a temporary rate limit of one request per 5 seconds.

Required Header Request

The following header is required on all requests:

x-api-key: The API key provided to you

Output Values for JSON

The following output values are returned after successful query:

Field
Description
aircraft_documents_id
The ID of the uploaded document
aircraft_id
The ID of the aircraft
aircraft_msn
The MSN construction number of the aircraft
aircraft_type
The type of the aircraft
title
The title of the uploaded document
document_url
The full URL to the uploaded document
file_size
The file size of the uploaded document
date_time
The date & time the document was uploaded, in 'Y-m-d hh:ii:ss' format and UTC timezone

Error Codes for JSON

The following are all error codes that can be returned with this function:

Error Message
Description
No API key provided!
No API key has been provided.
API key invalid!
The API key is invalid.
This API key is not associated to a Business account!
The API key provided is not associated with a Aviation Flights Business account.

Sample Output

{
  "status": "success",
  "results": [
    {
      "documents": [
        {
          "aircraft_documents_id": "4",
          "aircraft_id": "15123",
          "aircraft_msn": "2101",
          "aircraft_type": "A330-941",
          "title": "Flight Manual",
          "document_url": "https://aviation.flights/path-to-uploaded-document",
          "file_size": "2mb",
          "date_time": "2025-08-25 17:15:00"
        }
      ]
    }
  ]
}
Chat