Get All Drones Status

This API is called to query all the registered drones of the user and retrieve their latest status.

This API offers programmatic access to details about drones registered by users in AeroGCS Enterprise, including status and telemetry data. Integrate real-time drone information into your applications

Authentication

To use the API, insert your API key in the Authorization header like this:

Authorization: Bearer <YOUR_API_KEY>

Replace <YOUR_API_KEY> with your AeroGCS API key. Without it, you'll get a 401 Unauthorized error.

Method

GET : retrieves the status of all drones.

HTTP Request

https://ags.aeromegh.com/AeroMegh/getDronesStatus

Headers: "authorization": "Bearer <API_key>"

HTTP Response

Response codes explanation

Code	Details
200	message: "ok"
400	request parameters missing
500	internal server error

Code Snippet

Examples of how you can call this API using curl, Node.js, and Python

curl

curl --location 'https://ags.aeromegh.com/AeroMegh/getDronesStatus' \
--header 'Authorization: Bearer <API_KEY>'

Node

//Please install 'axios' module first
//Set your API key before making the request
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://ags.aeromegh.com/AeroMegh/getDronesStatus',
  headers: { 
    'Authorization': 'Bearer <API_KEY>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

//Please install 'requests' package first
//Set your API key before making the request
import requests

url = "https://ags.aeromegh.com/AeroMegh/getDronesStatus"

payload = {}
headers = {
  'Authorization': 'Bearer <API_KEY>'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Note: Replace <API_KEY> with the actual API_KEY provided by Aeromegh.

API Response

Example of API Response in JSON format.

{
    "drones": [
        {
            "drone_id": "P000010024003B3131510137383337",
            "drone_name": "KAM29032024",
            "userid": "598cc675-8126-4d62-be60-03c8d4b5e62b",
            "project": "ManualProject",
            "plan": "SprayingPlan",
            "last_keep_alive": "2024-05-06T10:37:39.645Z",
            "last_tele_data": "{\"message\":\"Disarming Motors\",\"type\":\"INFO\"}",
            "total_flight_time": {
                "hours": 4,
                "minutes": 50,
                "seconds": 56,
                "milliseconds": 744
            },
            "last_flight_log": null,
            "flight_id": "f45c2575-c5f4-4323-baf3-7e719e3c8059",
            "stream_key": "",
            "registered_date": "2024-03-29T06:46:45.691Z",
            "lease_drone": false,
            "drone_rent": "0",
            "dsp_drone_id": null,
            "uin": "dfgdfgfg",
            "id": "ba3c252a-e624-4850-9cf7-6845ba9af631",
            "model": null,
            "serial_no": null,
            "fcsno": "1234",
            "rcsno": "MK15",
            "board_type": null,
            "green_build_number": null,
            "device_ram": null,
            "android_version": null,
            "device_model_name": null,
            "firmware_version": null,
            "license_type": null,
            "topic": "rbxx6tw60sjf24snu3zot97t31s5rt2gnec2qcwtkk3yw06j91jrwa563116ai07",
            "status": "{\"type\":\"INFO\",\"message\":\"Flight moving safely\",\"timestamp\":1715325835.472}",
            "online": false,
            "flightID": "f45c2575-c5f4-4323-baf3-7e719e3c8059",
            "teleData": {
                "message": "Disarming Motors",
                "type": "INFO"
            }
        },
        {
            "drone_id": "P00001DESKTOP-QFR1AP5",
            "drone_name": "Abhishek",
            "userid": "598cc675-8126-4d62-be60-03c8d4b5e62b",
            "project": "ManualProject",
            "plan": "SprayingPlan",
            "last_keep_alive": "2024-04-27T07:02:06.951Z",
            "last_tele_data": "{\"message\":\"Disarming Motors\",\"type\":\"INFO\"}",
            "total_flight_time": {
                "seconds": 8,
                "milliseconds": 80
            },
            "last_flight_log": null,
            "flight_id": "a043e414-664a-4369-8201-8bc5e3886195",
            "stream_key": "",
            "registered_date": "2024-04-26T09:58:09.562Z",
            "lease_drone": false,
            "drone_rent": "0",
            "dsp_drone_id": null,
            "uin": "fyuiighj",
            "id": "7efc6dcf-93ad-44ce-8fa0-8d0a85c50e89",
            "model": null,
            "serial_no": null,
            "fcsno": "",
            "rcsno": "",
            "board_type": null,
            "green_build_number": "102.257.20240419.01",
            "device_ram": "5.73 GB",
            "android_version": "Android 14",
            "device_model_name": "Realme RMX3710",
            "firmware_version": "ArduCopter V4.5.1 (913ec4b2)",
            "license_type": "15 Days Trial",
            "topic": "cbglr44gomuslhdslyyrklvopwigwew0059c0pbln5evwt7mu5hz8rlh4zui5ewd",
            "status": "{\"type\":\"INFO\",\"message\":\"Flight moving safely\",\"timestamp\":1715325835.472}",
            "online": false,
            "flightID": "a043e414-664a-4369-8201-8bc5e3886195",
            "teleData": {
                "message": "Disarming Motors",
                "type": "INFO"
            }
        },
        {
            "drone_id": "P00001004C00333032511433383839",
            "drone_name": "mo-hit",
            "userid": "598cc675-8126-4d62-be60-03c8d4b5e62b",
            "project": "2",
            "plan": "2",
            "last_keep_alive": "2024-04-15T12:31:55.537Z",
            "last_tele_data": "{\"message\":\"Disarming Motors\",\"type\":\"INFO\"}",
            "total_flight_time": {
                "minutes": 12,
                "seconds": 42,
                "milliseconds": 55
            },
            "last_flight_log": null,
            "flight_id": "6ba9d881-2552-4cbe-9017-592b1d7305e2",
            "stream_key": "",
            "registered_date": "2024-04-15T12:08:00.734Z",
            "lease_drone": false,
            "drone_rent": "0",
            "dsp_drone_id": null,
            "uin": ".......",
            "id": "ab406ac3-4253-45c0-94e3-b1318b7d0cdb",
            "model": null,
            "serial_no": null,
            "fcsno": "",
            "rcsno": "",
            "board_type": "CubeOrangePlus",
            "green_build_number": "101.221.20240405.01",
            "device_ram": "11.22 GB",
            "android_version": "Android 14",
            "device_model_name": "OnePlus CPH2415",
            "firmware_version": "ArduCopter V4.4.4",
            "license_type": "OEM",
            "topic": "67b6sqxemr1m6bqtcd4o49r95uz7egpkp347w9hg43cfndfp6n4k005j6w4vaggt",
            "status": "{\"type\":\"INFO\",\"message\":\"Flight moving safely\",\"timestamp\":1715325835.472}",
            "online": false,
            "flightID": "6ba9d881-2552-4cbe-9017-592b1d7305e2",
            "teleData": {
                "message": "Disarming Motors",
                "type": "INFO"
            }
        }
    ]
}

API Response Parameter

The following table outlines the parameters included in the API response for each drone:

Parameter	Description	Sub-Parameters
drone_id	Unique identifier for the drone.	-
drone_name	Name assigned to the drone.	-
userid	Unique identifier for the user associated with the drone.	-
project	Project the drone is assigned to.	-
plan	Plan associated with the drone.	-
last_keep_alive	Timestamp indicating the last time the drone communicated its status.	-
last_tele_data	Information about the last telemetry data received from the drone, including a message and its type.	- message: Message received from the drone. - type: Type of telemetry data (e.g., INFO).
total_flight_time	Total duration of flight recorded in hours, minutes, seconds, and milliseconds.	- hours: Total hours of flight. - minutes: Total minutes of flight. - seconds: Total seconds of flight. - milliseconds: Total milliseconds of flight.
last_flight_log	Timestamp of the last recorded flight log.	-
flight_id	Unique identifier for the flight.	-
stream_key	Key for streaming data.	-
registered_date	Timestamp indicating the date and time when the drone was registered.	-
lease_drone	Indicates whether the drone is leased.	-
drone_rent	Rental fee for the drone.	-
dsp_drone_id	Identifier for the drone in the Digital Sky Platform.	-
uin	Unique Identification Number associated with the drone.	-
model	Model of the drone.	-
serial_no	Serial number of the drone.	-
fcsno	Flight Control System number.	-
rcsno	Remote Control System number.	-
board_type	Type of board used in the drone.	-
green_build_number	Build number for the green firmware.	-
device_ram	Amount of RAM available on the device.	-
android_version	Version of the Android operating system.	-
device_model_name	Name of the device model.	-
firmware_version	Version of the firmware installed on the drone.	-
license_type	Type of license associated with the drone.	-
topic	Topic associated with the drone.	-
status	Current status of the drone, including a message, type, and timestamp.	- message: Current status message (e.g., "Flight moving safely"). - type: Type of status message (e.g., INFO). - timestamp: Timestamp of the status message.
online	Indicates whether the drone is online.	-
flightID	Unique identifier for the flight (alternative field).	-
teleData	Information about telemetry data received from the drone, including a message and its type (alternative field).	- message: Message received from the drone. - type: Type of telemetry data (e.g., INFO).