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

# List backfills

> Returns all backfill jobs for the authenticated user's organization.

```
GET /api/v1/beam/backfills
```

Returns all backfill jobs created by the authenticated user's organization, ordered by creation time.

```bash theme={null}
curl -X GET https://api.allium.so/api/v1/beam/backfills \
  -H "X-API-Key: ${ALLIUM_API_KEY}"
```

**Response:**

```json theme={null}
[
  {
    "job_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "workflow_id": "beam-backfill-org123-f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "organization_id": "org123",
    "status": "transporting",
    "job_name": "USDC transfers Jan 2024",
    "table": "base.assets.erc20_token_transfers",
    "partition_key": "block_timestamp",
    "backfill_start": "2024-01-01T00:00:00",
    "backfill_end": "2024-02-01T00:00:00",
    "filter_column": "token_address",
    "filter_values": ["0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"],
    "destinations": [
      { "type": "kafka", "name": "base-usdc-transfers-backfill", "uid": "..." }
    ],
    "static_egress_ip": false,
    "num_chunks": 1000,
    "chunks_left": 423,
    "error_message": null,
    "time_created": "2024-04-27T10:30:00Z",
    "time_completed": null
  }
]
```

**Response fields:**

| Field                             | Description                                                              |
| :-------------------------------- | :----------------------------------------------------------------------- |
| `job_id`                          | Unique job identifier                                                    |
| `status`                          | Current job state — see statuses below                                   |
| `job_name`                        | Display name provided at creation                                        |
| `table`                           | Source Snowflake table                                                   |
| `partition_key`                   | `"block_timestamp"`                                                      |
| `backfill_start` / `backfill_end` | Window bounds (inclusive start, exclusive end)                           |
| `filter_column` / `filter_values` | Column filter applied to the export, or `null` if none                   |
| `num_chunks`                      | Total parquet files staged from Snowflake, or `null` while still staging |
| `chunks_left`                     | Remaining files to deliver; counts down to `0`                           |
| `error_message`                   | Set on `failed` jobs; `null` otherwise                                   |
| `time_created`                    | ISO 8601 UTC timestamp                                                   |
| `time_completed`                  | ISO 8601 UTC timestamp, or `null` if not yet finished                    |

**Job statuses:**

| Status         | Description                                    |
| :------------- | :--------------------------------------------- |
| `staging`      | Exporting data from Snowflake to GCS           |
| `transporting` | Delivering parquet chunks to destinations      |
| `completed`    | All chunks delivered successfully              |
| `failed`       | Job encountered an error (see `error_message`) |
| `cancelled`    | Job was cancelled via the cancel endpoint      |