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

# Managing Equipment

> List equipment, retrieve details, and access flight logs using the Equipment API

# Managing Equipment

The Equipment API lets you access your organization's fleet — drones, sensors, cameras, and other equipment — along with their flight logs.

## List your fleet

Retrieve all equipment in your organization:

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

The response includes all active equipment with details like manufacturer, model, serial number, and status.

### Pagination

Results are paginated with a default of 20 items per page (max 100):

```bash theme={null}
curl "https://api.dronelist.io/v1/equipment?page=1&limit=50" \
  -H "X-API-Key: dl_your_key_here"
```

See [Pagination](/docs/pagination) for details on iterating through results.

## Get equipment details

Retrieve a specific piece of equipment by its ID:

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

## Access flight logs

Retrieve the flight history for a specific piece of equipment:

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

### Flight log filters

| Parameter    | Type     | Description                    |
| ------------ | -------- | ------------------------------ |
| `dateFrom`   | ISO 8601 | Filter flights from this date  |
| `dateTo`     | ISO 8601 | Filter flights up to this date |
| `flightType` | string   | Filter by flight type          |
| `orderBy`    | string   | Sort order (e.g., `date_desc`) |
| `page`       | integer  | Page number                    |
| `limit`      | integer  | Items per page                 |

```bash theme={null}
curl "https://api.dronelist.io/v1/equipment/eq_abc123/flights?dateFrom=2025-01-01&dateTo=2025-03-31&orderBy=date_desc&limit=50" \
  -H "X-API-Key: dl_your_key_here"
```

## Common use cases

<AccordionGroup>
  <Accordion title="Fleet inventory dashboard">
    Fetch all equipment and group by type or status to build a fleet overview in your internal tools.
  </Accordion>

  <Accordion title="Flight hour tracking">
    Aggregate flight logs across your fleet to track total flight hours for compliance and maintenance scheduling.
  </Accordion>

  <Accordion title="Maintenance alerts">
    Monitor equipment status and flight hours to trigger maintenance alerts when thresholds are reached.
  </Accordion>
</AccordionGroup>

## Required scope

All equipment endpoints require the `equipment:read` scope on your API key.