> ## Documentation index
> Fetch the complete documentation index at: https://dronebundle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Jobs

> List jobs across every project in your workspace.

`GET https://api.dronebundle.com/v1/jobs`

Requires an API key with `read_only` or `full_access` scope.

Returns jobs from all projects in your workspace, with the pilots assigned to each. To list the jobs of one project, use [List Project Jobs](https://dronebundle.com/docs/api-reference/jobs/list-project-jobs).

Results are paginated. A page can hold fewer jobs than `limit` while `cursor` is still set, so keep requesting pages until `cursor` is `null`.

## Query parameters

**limit** `number`

How many jobs to read per page. Between 1 and 100.

**cursor** `string`

Pagination cursor from a previous response. Omit for the first page.

**excludeCompleted** `boolean` (default: false)

Set to `true` to leave out completed jobs.

## Response

**jobs** `object[]`

Array of job objects.

**id** `string`

Job ID.

**name** `string`

Job name.

**description** `string`

Job description.

**type** `string`

Job type (e.g. `drone_inspection`, `thermal_inspection`).

**status** `string`

Job status.

**other_status_reason** `string`

Reason given when `status` is `other`.

**priority** `string`

Priority level (`low`, `medium`, or `high`).

**project_id** `string`

The project this job belongs to.

**job_pattern** `string`

`one_time` or `recurring`.

**start_date** `string`

Start date in ISO 8601 format.

**end_date** `string | null`

End date in ISO 8601 format, or `null` if not set.

**latitude** `number`

Latitude of the job location.

**longitude** `number`

Longitude of the job location.

**inspection_notes** `string`

Inspection notes.

**assigned_pilots** `object[]`

Pilots assigned to the job.

**id** `string`

User ID of the pilot.

**email** `string`

Pilot's email address.

**first_name** `string`

First name.

**last_name** `string`

Last name.

**profile_picture** `string | null`

URL of the profile picture.

**assigned_at** `number`

Unix timestamp (milliseconds) when the pilot was assigned.

**assigned_by** `object | null`

The team member who assigned the pilot, with `id`, `email`, `first_name`, `last_name` and `profile_picture`.

**recurring_frequency** `string`

Recurrence frequency, on recurring jobs.

**recurring_interval** `number`

Repeat every N periods, on recurring jobs.

**selected_days_of_week** `number[] | null`

Days of the week (0 = Sunday, 6 = Saturday).

**week_of_month** `number | null`

Week of the month (1-4, or -1 for last week).

**weeks_of_month** `number[] | null`

Multiple weeks of the month.

**flights_per_occurrence** `number | null`

Number of flights per occurrence.

**flight_slots** `object[] | null`

Planned flight times for each occurrence, if set.

**timezone** `string | null`

Time zone of the flight times (e.g. `Europe/Copenhagen`).

**file_count** `number`

Number of files on the job.

**file_counts_by_category** `object`

Number of files in each category: `before`, `during`, `after`, `report` and `general`.

**created** `number`

Unix timestamp (milliseconds) when the job was created.

**updated** `number`

Unix timestamp (milliseconds) when the job was last updated.

**count** `number`

Number of jobs in this page.

**cursor** `string | null`

Cursor for the next page. `null` when there are no more results.

### Example request

```bash cURL
curl -X GET "https://api.dronebundle.com/v1/jobs?limit=50&excludeCompleted=true" \
  -H "Authorization: Bearer v1_your_api_key_here"
```

### Example response

```json 200
{
  "jobs": [
    {
      "id": "019d4350-a1b2-7c3d-8e4f-567890abcdef",
      "name": "Roof Inspection - Building A",
      "description": "Inspect roof for damage after storm.",
      "type": "drone_inspection",
      "status": "planned",
      "priority": "high",
      "project_id": "01964c6b-7a3e-7f00-8000-abc123def456",
      "job_pattern": "one_time",
      "start_date": "2026-04-20",
      "end_date": null,
      "latitude": 55.6761,
      "longitude": 12.5683,
      "inspection_notes": "Check the north gutters.",
      "assigned_pilots": [
        {
          "id": "03144892-6021-705a-08f2-8e147cff3f28",
          "email": "sarah@example.com",
          "first_name": "Sarah",
          "last_name": "Chen",
          "profile_picture": null,
          "assigned_at": 1743500000000,
          "assigned_by": null
        }
      ],
      "selected_days_of_week": null,
      "week_of_month": null,
      "weeks_of_month": null,
      "flights_per_occurrence": null,
      "flight_slots": null,
      "timezone": null,
      "file_count": 12,
      "file_counts_by_category": {
        "before": 0,
        "during": 12,
        "after": 0,
        "report": 0,
        "general": 0
      },
      "created": 1743400000000,
      "updated": 1743500000000
    }
  ],
  "count": 1,
  "cursor": "eyJQSyI6IkpPQiMwMTk4..."
}
```

Web version: https://dronebundle.com/docs/api-reference/jobs/list-jobs
