> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.labric.co/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.labric.co/_mcp/server.

# List tables

GET https://platform.labric.co/api/v1/data/tables

List the tables SQL queries can target, without their columns.

Returns each table's name, semantic category, description, column count,
and the tables its foreign keys reference: the org's own tables first, then
the platform tables (core_experiment, core_instrument, and similar), whose
descriptions are cut to one line. Call this first to find the tables a task needs and how they join, then pass
their names to get_schema for the columns.

Requires an API key with the `read` scope.

Reference: https://docs.labric.co/api-reference/labric-api/data/list-tables

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Response

### 200

OK

- `list of TableSummarySchema`

## Errors

### 400 Bad Request Error

Bad Request

- `detail` (string, required)

### 401 Unauthorized Error

Unauthorized

- `detail` (string, required)

### 403 Forbidden Error

Forbidden

- `detail` (string, required)

### 404 Not Found Error

Not Found

- `detail` (string, required)

### 422 Unprocessable Entity Error

Unprocessable Content

- `detail` (list of map from string to any, required)

### 500 Internal Server Error

Internal Server Error

- `detail` (string, required)

## Types

### TableSummarySchema

A table SQL queries can target, without its columns.

- `name` (string, required) — Pass this to get_schema to read the columns.
- `column_count` (integer, required)
- `references` (list of string, required) — Names of the tables this table's foreign keys point to.
- `semantic_category` (string, optional, nullable)
- `description` (string, optional, nullable)

## Examples

**Response**

```json
[
  {
    "name": "string",
    "column_count": 1,
    "references": [
      "string"
    ],
    "semantic_category": "string",
    "description": "string"
  }
]
```

**SDK Code**

```python
import requests

url = "https://platform.labric.co/api/v1/data/tables"

headers = {"Authorization": "Bearer <api_key>"}

response = requests.get(url, headers=headers)

print(response.json())
```