Available languages: [Python](https://databento.com/docs/api-historical/batch/batch-list-jobs.python.md) · [C++](https://databento.com/docs/api-historical/batch/batch-list-jobs.cpp.md) · [Rust](https://databento.com/docs/api-historical/batch/batch-list-jobs.rust.md) · [HTTP](https://databento.com/docs/api-historical/batch/batch-list-jobs.http.md)

Source: https://databento.com/docs/api-historical/batch/batch-list-jobs



### Historical.batch.list_jobs

List batch job details for the user account.

The job details will be sorted in order of `ts_received`.

To obtain the full details for a job, use [batch.get_job_details](https://databento.com/docs/api-historical/batch/batch-get-job-details.md), which returns the full set of fields for a single job.

Related: [Download center]($PLATFORM_HOSTNAME/portal/download-center).

#### API method

```python
Historical.batch.list_jobs(
    states: Iterable[JobState | str] | JobState | str | None = "queued,processing,done",
    since: pd.Timestamp | datetime | date | str | int | None = None,
) -> list[dict[str, Any]]
```

#### Parameters

| Parameter | Type | Required | Description |
| `states` | Iterable[JobState \ | str] or JobState or str | optional | The filter for job states as a list of comma separated values. Can include 'queued', 'processing', 'done', and 'expired'. Defaults to all except 'expired'. |
| `since` | pd.Timestamp, datetime, date, str, or int | optional | The filter for timestamp submitted (will not include jobs prior to this). Takes [pd.Timestamp](https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.Timestamp.html), [Python datetime](https://docs.python.org/3/library/datetime.html#datetime-objects), [Python date](https://docs.python.org/3/library/datetime.html#date-objects), [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) string, or [UNIX timestamp](https://en.wikipedia.org/wiki/Unix_time) in nanoseconds. Assumes UTC as timezone unless otherwise specified. |

#### Returns

`list[dict[str, Any]]`

A list of batch job details.

| Field | Type | Description |
| `id` | str | The unique job ID for the request. |
| `state` | str | The current status of the batch job. One of 'queued', 'processing', 'done', or 'expired'. |
| `ts_received` | str | The ISO 8601 timestamp when Databento received the batch job. |

#### Example usage

```python
import databento as db

client = db.Historical("$YOUR_API_KEY")

jobs = client.batch.list_jobs(
    states=["queued", "processing", "done"],
    since="2022-06-01",
)
print(jobs)
```
#### Example response

```plaintext
[
    {
        "id": "GLBX-20221126-DBVXWPJJQN",
        "state": "done",
        "ts_received": "2022-11-26T09:23:17.519708000Z"
    },
...
```
