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

# release_batches()

> Download release batch metadata

```python theme={null}
client.release_batches() -> pd.DataFrame
```

Download release batch metadata including batch names, descriptions, and release dates.

## Returns

`pd.DataFrame` with release batch data.

## Example

```python theme={null}
from jmail import JmailClient

client = JmailClient()
batches = client.release_batches()

# Show all batches sorted by release date
print(batches.sort_values("released_at")[["name", "description", "released_at"]])
```

## Columns

| Column        | Type      | Description                                |
| ------------- | --------- | ------------------------------------------ |
| `id`          | int       | Batch ID                                   |
| `name`        | string    | Batch name (e.g., `VOL00009`, `DataSet11`) |
| `description` | string    | Batch description                          |
| `released_at` | timestamp | Public release date                        |

## Direct URLs

```
https://data.jmail.world/v1/release_batches.parquet
https://data.jmail.world/v1/release_batches.ndjson.gz
```