# Get Table

## Get Table

`POST /api/v1/dl/get_table`

Returns details for a single Tableflow table, looked up by UUID or by name.

### Request

| Field                | Type   | Required   | Description                              |
| -------------------- | ------ | ---------- | ---------------------------------------- |
| `virtual_cluster_id` | string | Yes        | The ID of the Tableflow virtual cluster. |
| `table_uuid`         | string | Optional\* | The UUID of the table to retrieve.       |
| `table_name`         | string | Optional\* | The name of the table to retrieve.       |

{% hint style="warning" %}
**Exactly one** of `table_uuid` or `table_name` must be specified. Providing both or neither will return an error.
{% endhint %}

#### CURL Example (by UUID)

```bash
curl [https://api.warpstream.com/api/v1/dl/get_table](https://api.warpstream.com/api/v1/dl/get_table) \
  -H 'warpstream-api-key: XXXXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{
    "virtual_cluster_id": "vci_XXXXXXXX_XXXX_XXXX_XXXX_XXXXXXXXXXXX", 
    "table_uuid": "550e8400-e29b-41d4-a716-446655440000"
  }'
```

### Response

```json
{
  "table": {
    "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="328.15234375"></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>table.table_name</code></td><td>string</td><td>The full name of the table.</td></tr><tr><td><code>table.table_uuid</code></td><td>string</td><td>The unique identifier of the table.</td></tr><tr><td><code>table.source_stream_name</code></td><td>string</td><td>The source Kafka topic name.</td></tr><tr><td><code>table.source_cluster_name</code></td><td>string</td><td>The name of the source cluster.</td></tr><tr><td><code>table.stats_estimated_byte_count</code></td><td>integer</td><td>Estimated total size of the table in bytes.</td></tr><tr><td><code>table.stats_estimated_row_count</code></td><td>integer</td><td>Estimated total number of rows in the table.</td></tr><tr><td><code>table.created_at_unix_nanos</code></td><td>integer</td><td>Table creation timestamp in nanoseconds since Unix epoch.</td></tr></tbody></table>