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

# Project Tracking

> List projects, filter by status, and retrieve project details using the Projects API

# Project Tracking

The Projects API gives you access to your organization's projects — from planning through completion.

## List projects

Retrieve all projects in your organization:

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

### Filter by status

Use the `status` query parameter to filter projects:

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

<Note>
  Invalid status values are silently ignored — the API returns all projects instead of an error.
</Note>

### Pagination

Results are paginated (default 20 items, max 100):

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

## Get project details

Retrieve full details for a specific project:

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

## Common use cases

<AccordionGroup>
  <Accordion title="Status board integration">
    Sync project statuses to external tools like Monday.com, Notion, or a custom dashboard to keep stakeholders informed.
  </Accordion>

  <Accordion title="Reporting and analytics">
    Pull project data periodically to build reports on project throughput, average completion time, and team utilization.
  </Accordion>

  <Accordion title="Client portal sync">
    Use the API to surface project progress in a client-facing portal, keeping your customers updated without manual effort.
  </Accordion>
</AccordionGroup>

## Required scope

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