Skip to main content
GET
/
v1
/
equipment
/
{id}
/
flights
List Flight Logs
curl --request GET \
  --url https://api.example.com/v1/equipment/{id}/flights

Documentation Index

Fetch the complete documentation index at: https://dronelist.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

List Flight Logs

Returns a paginated list of flight logs for a specific piece of equipment.

Request

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

Path parameters

ParameterTypeDescription
idstringEquipment ID (e.g., eq_abc123)

Query parameters

ParameterTypeDefaultDescription
dateFromISO 8601Filter flights from this date
dateToISO 8601Filter flights up to this date
flightTypestringFilter by flight type (COMMERCIAL, RECREATIONAL, TRAINING, MAINTENANCE)
orderByenumdate_descSort order: date_asc, date_desc, duration_asc, duration_desc
pageinteger1Page number (1-indexed)
limitinteger20Items per page (max 100)

Response

{
  "success": true,
  "data": [
    {
      "id": "fl_xyz789",
      "flightDate": "2025-03-15T09:00:00.000Z",
      "flightType": "COMMERCIAL",
      "operationType": "SURVEY",
      "durationSeconds": 1920,
      "maxAltitude": 120,
      "traveledDistance": 4500,
      "nightFlight": false,
      "bvlos": false,
      "takeoffLat": 51.5074,
      "takeoffLng": -0.1278,
      "landingLat": 51.5080,
      "landingLng": -0.1270,
      "pilotInCommand": {
        "id": "prof_abc123",
        "fullName": "Jane Smith"
      },
      "project": {
        "id": "proj_def456",
        "title": "Highway Bridge Inspection Q1"
      },
      "createdAt": "2025-03-15T09:35:00.000Z",
      "updatedAt": "2025-03-15T09:35:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 18,
      "hasMore": false
    }
  }
}
pilotInCommand and project may be null if no pilot or project is associated with the flight.

Required scope

equipment:read

Errors

StatusCodeDescription
400BAD_REQUESTInvalid query parameters (e.g., malformed date or invalid orderBy value)
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENAPI key lacks equipment:read scope
404NOT_FOUNDEquipment not found or belongs to another organization
500INTERNAL_ERRORUnexpected server error — retry with exponential backoff