List Projects

List all projects in your workspace.

cURL

curl -X GET "https://api.dronebundle.com/v1/projects?status=in_progress,planned" \
  -H "Authorization: Bearer v1_your_api_key_here"

200

{
  "projects": [
    {
      "id": "01964c6b-7a3e-7f00-8000-abc123def456",
      "name": "Bridge Inspection Q2",
      "description": "Quarterly drone inspection of the Westfield Bridge.",
      "status": "in_progress",
      "start_date": "2026-04-15",
      "end_date": "2026-04-30",
      "created": 1743400000000,
      "updated": 1743500000000,
      "archived": false,
      "external_id": "PROJ-1042",
      "created_by": {
        "id": "user-abc-123",
        "email": "[e-mail]",
        "first_name": "Sarah",
        "last_name": "Chen",
        "profile_picture": null
      }
    }
  ],
  "count": 1,
  "cursor": null
}

Requires an API key with read_only or full_access scope.

Returns a paginated list of projects. Results are returned in pages of up to 50 projects.

Query parameters

cursor · string

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

status · string

Filter by status. Comma-separated for multiple values (e.g. in_progress,planned).

archived · string

Set to true to list only archived projects. Defaults to non-archived projects.

Response

projects · object[]

Array of project objects.

Show project object

id · string

Project ID.

name · string

Project name.

description · string

Project description.

status · string

Project status.

start_date · string

Start date in ISO 8601 format.

end_date · string | null

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

created · number

Unix timestamp (milliseconds) when the project was created.

updated · number

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

archived · boolean

Whether the project is archived.

external_id · string | null

External identifier, if set.

laanc_number · string | null

LAANC authorization number, if set.

created_by · object

The user or API key that created the project.

Show properties

id · string

User ID or API key ID.

email · string | null

User email. null for API key-created projects.

first_name · string | null

First name, or API key name for API key-created projects.

last_name · string | null

Last name. null for API key-created projects.

profile_picture · string | null

Profile picture URL.

count · number

Number of projects in the current page.

cursor · string | null

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

cURL

curl -X GET "https://api.dronebundle.com/v1/projects?status=in_progress,planned" \
  -H "Authorization: Bearer v1_your_api_key_here"

200

{
  "projects": [
    {
      "id": "01964c6b-7a3e-7f00-8000-abc123def456",
      "name": "Bridge Inspection Q2",
      "description": "Quarterly drone inspection of the Westfield Bridge.",
      "status": "in_progress",
      "start_date": "2026-04-15",
      "end_date": "2026-04-30",
      "created": 1743400000000,
      "updated": 1743500000000,
      "archived": false,
      "external_id": "PROJ-1042",
      "created_by": {
        "id": "user-abc-123",
        "email": "[e-mail]",
        "first_name": "Sarah",
        "last_name": "Chen",
        "profile_picture": null
      }
    }
  ],
  "count": 1,
  "cursor": null
}