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 under Settings → API Keys

Step 1: Create an API key

Open Settings → API Keys. Click Create Key and pick the scopes you need:

Scope	Access
`equipment:read`	Equipment list and details
`service:read`	Service list and details

Copy the key — it starts with dl_live_ and is only shown once.

Step 2: Make your first request

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

const response = await fetch('https://api.dronelist.io/v1/equipment', {
  headers: { 'X-API-Key': 'dl_live_your_key_here' }
});

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.dronelist.io/v1/equipment',
    headers={'X-API-Key': 'dl_live_your_key_here'}
)

print(response.json())

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.

Last modified on September 7, 2026

Getting started

Core concepts

Guides

Endpoints

Quickstart

Quickstart

Prerequisites

Step 1: Create an API key

Step 2: Make your first request

Step 3: Check the response

Next steps

Authentication

Pagination

Error handling

API Reference

​Quickstart

​Prerequisites

​Step 1: Create an API key

​Step 2: Make your first request

​Step 3: Check the response

​Next steps

Authentication

Pagination

Error handling

API Reference

Quickstart

Prerequisites

Step 1: Create an API key

Step 2: Make your first request

Step 3: Check the response

Next steps