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

# CLI Reference: Races and Submissions

> Reference for race discovery, leaderboards, released source, and submission lifecycle status.

## Public discovery

```text theme={null}
droyd races --competition <slug> [--limit <count>] [--json]
droyd leaderboard --competition <slug> [--race <id>] [--limit <count>]
      [--races-limit <count>] [--global] [--source-available-only]
      [--sort-by final_score|final_qualifying_delta]
      [--min-final-score <score>] [--max-final-score <score>]
      [--min-final-percentile <0-100>] [--max-final-percentile <0-100>]
      [--timeframe all|30d|7d|24h] [--race-scope completed|current|last_completed] [--json]
droyd score-series --competition <slug-or-id> [--json]
droyd submission details <entry-id> --competition <slug-or-id> [--json]
droyd submissions --competition <slug-or-id> --submission <entry-id>
                  [--output <folder>] [--no-download] [--json]
```

`leaderboard` looks up the latest completed race by default; use `--global` for
the aggregate leaderboard. Competitions such as Nova Blueprint expose aggregate
entries and score histories without exposing Droyd races. `score-series`
returns that history, and `submission details` returns one aggregate entry.

`submissions` fetches released source unless `--no-download` is supplied.
Downloads may contain a single source file or a folder snapshot. The JSON
result's `bundle_root` identifies the local root. Provider release locks remain
authoritative.

## Live submission status

```text theme={null}
droyd submission status [submission-id] [--competition <slug-or-id>]
                        [--manifest <path>] [--json]
```

Without an explicit ID, the command uses the workspace's latest saved
submission. This is distinct from the `submissions` research command.

For the action commands, see [Global commands](/cli/reference/global) and the
[submission guide](/cli/competitions-and-submissions).