# List

List recent test uploads for your organisation.

```bash
dcd list [flags]
```

## Flags

| Flag               | Default | Description                                                                                           |
| ------------------ | ------- | ----------------------------------------------------------------------------------------------------- |
| `--limit <n>`      | `20`    | Maximum number of uploads to return                                                                   |
| `--offset <n>`     | `0`     | Number of uploads to skip (for pagination)                                                            |
| `--name <pattern>` |         | Filter by upload name. Supports `*` as a wildcard — always quote wildcards to prevent shell expansion |
| `--from <date>`    |         | Return uploads created on or after this date (ISO 8601, e.g. `2024-01-01`)                            |
| `--to <date>`      |         | Return uploads created on or before this date (ISO 8601)                                              |
| `--api-key <key>`  |         | Your DeviceCloud API key. Defaults to `DEVICE_CLOUD_API_KEY` env var                                  |
| `--json`           |         | Output results as JSON                                                                                |

## Examples

```bash
# List the 20 most recent uploads
dcd list

# List with a wildcard name filter (note the quotes)
dcd list --name "nightly-*"

# Filter by date range
dcd list --from 2024-01-01 --to 2024-01-31

# Paginate
dcd list --limit 10 --offset 20

# JSON output
dcd list --json
```

{% hint style="info" %}
Always quote wildcard patterns to prevent your shell from expanding them before they reach the CLI — use `"nightly-*"` not `nightly-*`.
{% endhint %}

## Output

```
Recent Uploads
════════════════════════════════════════════════════════════════════════════════
   Showing 3 of 3 uploads

   Nightly regression
      ID:      7e12345f-eb12-12ec-a30b-bb1234f1d12a
      Created: Jan 15, 2026, 10:30 AM
      Console: https://console.devicecloud.dev/results?upload=7e12345f-...

   Smoke tests
      ID:      ...
      ...

Tip: Use dcd status --upload-id <id> for detailed test results
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devicecloud.dev/cli-reference/dcd-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.