# List Tables

`POST /api/v1/dl/list_tables`

Returns all active Tableflow tables for a given virtual cluster.

### Request

| Field                | Type   | Required | Description                              |
| -------------------- | ------ | -------- | ---------------------------------------- |
| `virtual_cluster_id` | string | Yes      | The ID of the Tableflow virtual cluster. |

#### CURL Example

```bash
curl [https://api.warpstream.com/api/v1/dl/list_tables](https://api.warpstream.com/api/v1/dl/list_tables) \
  -H 'warpstream-api-key: XXXXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{"virtual_cluster_id": "vci_XXXXXXXX_XXXX_XXXX_XXXX_XXXXXXXXXXXX"}'
```

### Response

```json
{
  "tables": [
    {
      "table_name": "my_cluster.my_topic.a1b2c3d4",
      "table_uuid": "550e8400-e29b-41d4-a716-446655440000",
      "source_stream_name": "my_topic",
      "source_cluster_name": "my_cluster",
      "stats_estimated_byte_count": 1048576,
      "stats_estimated_row_count": 10000,
      "created_at_unix_nanos": 1700000000000000000
    }
  ]
}
```

<table data-header-hidden><thead><tr><th width="336.7734375"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td></tr><tr><td><code>tables</code></td><td>array</td><td>List of table objects.</td></tr><tr><td><code>tables[].table_name</code></td><td>string</td><td>The full name of the table.</td></tr><tr><td><code>tables[].table_uuid</code></td><td>string</td><td>The unique identifier of the table.</td></tr><tr><td><code>tables[].source_stream_name</code></td><td>string</td><td>The source Kafka topic name.</td></tr><tr><td><code>tables[].source_cluster_name</code></td><td>string</td><td>The name of the source cluster.</td></tr><tr><td><code>tables[].stats_estimated_byte_count</code></td><td>integer</td><td>Estimated total size of the table in bytes.</td></tr><tr><td><code>tables[].stats_estimated_row_count</code></td><td>integer</td><td>Estimated total number of rows in the table.</td></tr><tr><td><code>tables[].created_at_unix_nanos</code></td><td>integer</td><td>Table creation timestamp in nanoseconds since Unix epoch.</td></tr></tbody></table>