# src search-jobs list

<p className="subtitle">
	`src search-jobs list` is a tool that lists search jobs on a Sourcegraph
	instance.
</p>

## Usage

```bash
Usage of 'src search-jobs list':
  -asc
        Sort search jobs in ascending order
  -c string
        Comma-separated list of columns to display. Available: id,query,state,username,createdat,startedat,finishedat,url,logurl,total,completed,failed,inprogress (default "id,username,state,query")
  -dump-requests
        Log GraphQL requests and responses to stdout
  -get-curl
        Print the curl command for executing this query and exit (WARNING: includes printing your access token!)
  -insecure-skip-verify
        Skip validation of TLS certificates against trusted chains
  -json
        Output results as JSON for programmatic access
  -limit int
        Limit the number of search jobs returned (default 10)
  -order-by string
        Sort search jobs by a sortable field (QUERY, CREATED_AT, STATE) (default "CREATED_AT")
  -trace
        Log the trace ID for requests. See https://docs.sourcegraph.com/admin/observability/tracing
  -user-agent-telemetry
        Include the operating system and architecture in the User-Agent sent with requests to Sourcegraph (default true)

        Examples:

          List all search jobs:

                $ src search-jobs list

          List all search jobs in ascending order:

                $ src search-jobs list --asc

          Limit the number of search jobs returned:

                $ src search-jobs list --limit 5

          Order search jobs by a field (must be one of: QUERY, CREATED_AT, STATE):

                $ src search-jobs list --order-by QUERY

          Select specific columns to display:

                $ src search-jobs list -c id,state,username,createdat

          Output results as JSON:

                $ src search-jobs list -json

          Combine options:

                $ src search-jobs list --limit 10 --order-by STATE --asc -c id,query,state

          Available columns are: id, query, state, username, createdat, startedat, finishedat,
          url, logurl, total, completed, failed, inprogress
```