Skip to main content

​
Quickstart

This guide walks you through making your first API call to dronelist.io.

​
Prerequisites

  • A dronelist.io account with an active organization
  • An API key (created in Settings > API Keys)

​
Step 1: Create an API key

Navigate to Settings > API Keys in your dashboard. Click Create API Key and select the scopes you need:
ScopeAccess
equipment:readEquipment list, details, and flight logs
project:readProject list and details
service:readService list and details
Copy the key — it starts with dl_ and is only shown once.

​
Step 2: Make your first request

curl https://api.dronelist.io/v1/equipment \
  -H "X-API-Key: dl_your_key_here"

​
Step 3: Check the response

A successful response looks like: 
{
  "success": true,
  "data": [
    {
      "id": "eq_abc123",
      "name": "DJI Matrice 350 RTK",
      "type": "drone",
      "manufacturer": "DJI",
      "model": "Matrice 350 RTK",
      "status": "ACTIVE",
      "serialNumber": "1ZNBJ...",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-03-10T14:22:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 5,
      "hasMore": false
    }
  }
}

​
Next steps

Authentication

Learn about API key scopes and auth methods.

Pagination

Handle large result sets with pagination.

Error handling

Understand error codes and how to handle them.

API Reference

Explore every endpoint in detail.