API Reference
REST API for mission management, fleet telemetry, and payload access. Available on Fleet and Enterprise tiers.
Base URL & Authentication
https://api.uavsynq.com/v1/
# All requests require API key in header
Authorization: Bearer <your-api-key>
Missions
/missions
List all missions in the organization. Returns mission ID, status, scheduled date, aircraft count, and completion percentage.
/missions
Create a new mission. Supply mission name, site boundary (GeoJSON polygon), aircraft assignments, and scheduled launch time.
{
"name": ,
"scheduled_at": ,
"boundary_geojson": { ... },
"aircraft_ids": [, , ]
}
/missions/{mission_id}/telemetry
Stream real-time telemetry for all aircraft in a mission. Returns position, altitude, battery, and signal quality per aircraft.
Fleet
/fleet
List all registered aircraft. Returns aircraft ID, model, serial number, online status, and current battery level.
/fleet
Register a new aircraft with the fleet. Supply model identifier and hardware serial number.
Payloads
/payloads
List ingested sensor payloads. Filter by mission ID, sensor type, or date range. Returns file metadata and download URLs.
/payloads/{payload_id}/download
Get a signed download URL for a specific payload file. URLs expire after 1 hour.
Rate Limits & Response Codes
- Rate limit: 1000 requests per 15-minute window per API key
- 200 — Success
- 400 — Bad request (validation error in request body)
- 401 — Invalid or expired API key
- 403 — Insufficient permissions for your plan tier
- 429 — Rate limit exceeded
- 500 — Server error — contact support if recurring