Getting Started with the REST API | Dronetag Help
Skip to main content
Dronetag Help
Products
Dronetag Scout
Dronetag Mini 4G
Dronetag RIDER
Dronetag BS gen.2
Dronetag Beacon gen.2
Dronetag Mini
Dronetag Beacon
Dronetag BS
Dronetag DRI
Apps
Dronetag App
Drone Scanner
Knowledge BaseDevelopersWhat's new
English
English
Čeština
SearchCtrlK
Developers
Introduction
How to integrate
Getting started
Integrate Using the API
Integrate Using InterUSS
Direct Hardware Integration
Pulling from our API
Getting Started with the REST API
Getting Started with Socket.io
Authenticating API Requests
Pushing to your API
Getting started
Protocols and formats
Data Sources Explained
Distribution types
Message Coverage
Monitoring Your Distribution
Troubleshooting
Guides
Choosing the Right Integration Method
Accessing Historical Telemetry
Accessing Real-Time Telemetry
Accessing Real-Time Device Status
Setting up TAK Server Integration
Understanding Altitude Values
Understanding DUMP Messages
Using Simulated Data
Migration Guides
Transition to Region-Based Telemetry Retrieval
Updating Your Authentication Method
Developers
Pulling from our API
Getting Started with the REST API
On this page
Getting Started with the REST API
The REST API is best for retrieving absolute current & historical telemetry data, accessing account data such as assets, devices, aircraft and more. Because you need to request data manually, it's not very suitable for real-time data streaming. For real-time data, we recommend looking at using our Socket.io endpoints.
Obtaining API Credentials​
To access our API, you’ll need to authenticate. There are two ways to do this:
Personal Token: Use your personal token to access data on your Dronetag account. This can be created in our app or using API.
OpenID Connect: Use OIDC for more advanced authentication methods and allowing you application to access other users private data.
Learn more about authentication
Consuming the API​
Once you have your credentials, you’re ready to start using the API. We recommend familiarizing yourself with the API documentation, which outlines all available endpoints and the data structures you’ll be working with.
Visit our API documentation
Understanding DUMP data format​
Our API uses a variety of data schemas, each designed for specific API resource. One of them is used more consistently across our services, and that is the Dronetag Unified Message Protocol (DUMP) format. If you're dealing with Remote ID data, this protocol will be particularly important to understand.
To help you better understand, we've created a detailed guide that breaks down the structure of DUMP messages and explains how to work with them effectively:
Guide: Understanding DUMP messages
Conditions for Telemetry Request Parameters​
Keep in mind that when making telemetry requests to our airspace endpoints (/v2/airspace/*), you must specify both a time range (from and to) and a geographical region (bbox).
There are a few exceptions to this requirement:
If you provide an operation_id, no other parameters are needed.
If you specify a uas_id, you can omit the bbox geographical region, but the time range is still required.
Please note that the bbox size is limited and intended for moderately sized regions. It is not possible to use bbox to cover large areas such as entire countries, continents, or the world.
If this conditions poses a challenge, we recommend exploring our data push methods.
Additional Guides​
We offer several other guides to help you navigate common use cases with our API. Whether you’re looking to retrieve current airspace information or historical data, these resources will give you the tools you need:
Guide: Accessing historical telemetry
Guide: Accessing real-time telemetry
Guide: Using Simulated Data
Explore more guides through the left sidebar to enhance your API usage.
Previous
Direct Hardware Integration
Next
Getting Started with Socket.io
Obtaining API Credentials
Consuming the API
Understanding DUMP data format
Conditions for Telemetry Request Parameters
Additional Guides
Find more
Dronetag Web App
Dronetag Website
Help
Troubleshooting guide
help@dronetag.cz
Copyright © 2026 Dronetag s.r.o.