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"
    }
]

---

With this single request, you can publish **one or multiple UAVs at a time** while retrieving real-time traffic data in the vicinity of the published UAVs.