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

# List Tables

> List data tables for the authenticated organization

## Query Parameters

<ParamField query="limit" type="number" default="50">
  Number of tables to return (max 1000)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of tables to skip
</ParamField>

## Response

<ResponseField name="tables" type="array">
  Array of tables in the organization
</ResponseField>

<ResponseField name="tables[].id" type="string">
  Table ID (e.g., `tbl_abc123xyz789`)
</ResponseField>

<ResponseField name="tables[].name" type="string">
  Table name
</ResponseField>

<ResponseField name="tables[].description" type="string">
  Optional table description
</ResponseField>

<ResponseField name="tables[].columns" type="array">
  Column definitions for the table
</ResponseField>

<ResponseField name="tables[].row_count" type="number">
  Number of rows in the table
</ResponseField>

<ResponseField name="tables[].created_at" type="string">
  ISO 8601 timestamp
</ResponseField>

<ResponseField name="tables[].updated_at" type="string">
  ISO 8601 timestamp
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.crewship.dev/v1/tables?limit=20&offset=0" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "tables": [
      {
        "id": "tbl_abc123xyz789",
        "name": "leads",
        "description": "Sales pipeline leads",
        "columns": [
          { "name": "company", "type": "text", "required": true },
          { "name": "score", "type": "number", "required": false }
        ],
        "row_count": 42,
        "created_at": "2024-01-15T10:35:00Z",
        "updated_at": "2024-01-20T08:12:00Z"
      }
    ]
  }
  ```
</ResponseExample>