Getting started

This guide shows how to quickly start using the SafeSky API to publish your UAVs and retrieve traffic for enhanced situational awareness.

---

Publish UAVs and See Traffic

By using the POST /uav endpoint, you can publish one or many UAVs to SafeSky. This allows your UAVs to be seen by manned aviation and simultaneously see traffic in their vicinity. This ensures enhanced safety during your flights.

Example Request:

POST /uav?show_nearby_traffic=true
Content-Type: application/json

[
    {
        "id": "UAV123",
        "latitude": 50.69378,
        "longitude": 4.39201,
        "altitude": 180
    },
    {
        "id": "UAV124",
        "latitude": 50.69400,
        "longitude": 4.39300,
        "altitude": 200
    }
]

Example Response:

[
     {
        "latitude": 48.86584,
        "longitude": 2.63723,
        "beacon_type": "JET",
        "call_sign": "IBE06CK",
        "transponder_type": "ADS-B",
        "last_update": 1733412793,
        "altitude": 10554,
        "vertical_rate": 2,
        "accuracy": 0,
        "altitude_accuracy": 0,
        "course": 205,
        "ground_speed": 237,
        "turn_rate": 0.0,
        "status": "AIRBORNE",
        "id": "3423C3"
    },
    {
        "latitude": 48.95459,
        "longitude": 2.44153,
        "beacon_type": "JET",
        "call_sign": "NJE419F",
        "transponder_type": "ADS-B",
        "last_update": 1733412793,
        "altitude": 0,
        "vertical_rate": 0,
        "accuracy": 0,
        "altitude_accuracy": 0,
        "course": 292,
        "ground_speed": 0,
        "turn_rate": 0.0,
        "status": "GROUNDED",
        "id": "494105"
    }
]

That's it!

With one single request, you have published one or multiple UAVs at a time while retrieving real-time traffic data in their vicinity.