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

> Retrieve a paginated list of all projects in your organization

# List Projects

Returns a paginated list of all projects in your organization.

## Request

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

### Query parameters

| Parameter | Type    | Default | Description                                                                                                                                                                                 |
| --------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `page`    | integer | `1`     | Page number (1-indexed)                                                                                                                                                                     |
| `limit`   | integer | `20`    | Items per page (max 100)                                                                                                                                                                    |
| `status`  | string  | —       | Filter by project status. Valid values: `DRAFT`, `CONFIRMED`, `SCHEDULED`, `IN_PROGRESS`, `DELIVERED`, `INVOICED`, `COMPLETED`, `CANCELLED`, `ON_HOLD`. Invalid values are silently ignored |

## Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "proj_def456",
      "title": "Highway Bridge Inspection Q1",
      "description": "Quarterly structural inspection of the I-90 bridge",
      "status": "IN_PROGRESS",
      "projectType": "inspection",
      "siteAddress": "I-90 Bridge, Springfield",
      "agreedPrice": 15000,
      "estimatedCost": 8500,
      "currency": "USD",
      "scheduledDate": "2025-03-15T00:00:00.000Z",
      "clientAccountName": "Springfield DOT",
      "assignedPilotName": "Jane Smith",
      "createdAt": "2025-02-20T08:00:00.000Z",
      "updatedAt": "2025-03-10T11:45:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 12,
      "hasMore": false
    }
  }
}
```

<Note>
  The detail endpoint returns two additional fields: `clientAccountEmail` and `crmDealName`. Use [Get Project Details](/docs/api-reference/endpoint/get-v1projectsid) for the full record.
</Note>

## Required scope

`project:read`

## Errors

| Status | Code             | Description                                              |
| ------ | ---------------- | -------------------------------------------------------- |
| `401`  | `UNAUTHORIZED`   | Missing or invalid API key                               |
| `403`  | `FORBIDDEN`      | API key lacks `project:read` scope                       |
| `500`  | `INTERNAL_ERROR` | Unexpected server error — retry with exponential backoff |