> ## 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

> Retrieve paginated flight logs for a specific piece of equipment

# List Flight Logs

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

## Request

```bash theme={null}
curl "https://api.dronelist.io/v1/equipment/eq_abc123/flights" \
  -H "X-API-Key: dl_your_key_here"
```

### Path parameters

| Parameter | Type   | Description                      |
| --------- | ------ | -------------------------------- |
| `id`      | string | Equipment ID (e.g., `eq_abc123`) |

### Query parameters

| Parameter    | Type     | Default     | Description                                                                     |
| ------------ | -------- | ----------- | ------------------------------------------------------------------------------- |
| `dateFrom`   | ISO 8601 | —           | Filter flights from this date                                                   |
| `dateTo`     | ISO 8601 | —           | Filter flights up to this date                                                  |
| `flightType` | string   | —           | Filter by flight type (`COMMERCIAL`, `RECREATIONAL`, `TRAINING`, `MAINTENANCE`) |
| `orderBy`    | enum     | `date_desc` | Sort order: `date_asc`, `date_desc`, `duration_asc`, `duration_desc`            |
| `page`       | integer  | `1`         | Page number (1-indexed)                                                         |
| `limit`      | integer  | `20`        | Items per page (max 100)                                                        |

## Response

```json theme={null}
{
  "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
    }
  }
}
```

<Note>
  `pilotInCommand` and `project` may be `null` if no pilot or project is associated with the flight.
</Note>

## Required scope

`equipment:read`

## Errors

| Status | Code             | Description                                                                |
| ------ | ---------------- | -------------------------------------------------------------------------- |
| `400`  | `BAD_REQUEST`    | Invalid query parameters (e.g., malformed date or invalid `orderBy` value) |
| `401`  | `UNAUTHORIZED`   | Missing or invalid API key                                                 |
| `403`  | `FORBIDDEN`      | API key lacks `equipment:read` scope                                       |
| `404`  | `NOT_FOUND`      | Equipment not found or belongs to another organization                     |
| `500`  | `INTERNAL_ERROR` | Unexpected server error — retry with exponential backoff                   |