List Tables

List all tables in a workspace. Returns table metadata including name, schema, and row counts.

GET/api/v1/tables

Authorization

apiKey
X-API-Key<token>

Your Sim API key (personal or workspace). Generate one from the Sim dashboard under Settings > API Keys.

In: header

Query Parameters

workspaceId*string

The unique identifier of the workspace.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET \  "https://www.sim.ai/api/v1/tables?workspaceId=YOUR_WORKSPACE_ID" \  -H "X-API-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "tables": [
      {
        "id": "tbl_abc123",
        "name": "contacts",
        "description": "Customer contacts",
        "schema": {
          "columns": [
            {
              "name": "email",
              "type": "string",
              "required": true,
              "unique": true
            }
          ]
        },
        "rowCount": 150,
        "maxRows": 10000,
        "createdAt": "2026-01-15T10:30:00Z",
        "updatedAt": "2026-01-15T10:30:00Z"
      }
    ],
    "totalCount": 1
  }
}
{
  "error": "string",
  "details": [
    {}
  ]
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}