> For the complete documentation index, see [llms.txt](https://ats-doc.gitbook.io/v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ats-doc.gitbook.io/v1/apis/quickstart-1.md).

# List Trading Jobs

This API lists the all the existing trading jobs.

URL: `/trading_job/list`\
Method: **`GET`**

## Response Structure

```json
[
    {
        "created_time": "<YYYY-MM-DD HH:mm:ss>",
        "exchange": {
            "namespace": "exchanges:<exchange name>"
        },
        "id": "<Unique job id 1>",
        "is_running": <true or false>,
        "last_started_time": "<YYYY-MM-DD HH:mm:ss or null>",
        "strategy": {
            "namespace": "strategies:<strategy name>"
        }
    },
    {
        "created_time": "<YYYY-MM-DD HH:mm:ss>",
        "exchange": {
            "namespace": "exchanges:<exchange name>"
        },
        "id": "<Unique job id 2>",
        "is_running": <true or false>,
        "last_started_time": "<YYYY-MM-DD HH:mm:ss or null>",
        "strategy": {
            "namespace": "strategies:<strategy name>"
        }
    },
    ...
]
```

The returned job ID is used for running, stopping and checking status of the trading job.
