> ## 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.

# Get Table

> Get a table definition and metadata

## Path Parameters

<ParamField path="id" type="string" required>
  Table ID
</ParamField>

## Response

<ResponseField name="id" type="string">
  Table ID
</ResponseField>

<ResponseField name="name" type="string">
  Table name
</ResponseField>

<ResponseField name="description" type="string">
  Table description or `null`
</ResponseField>

<ResponseField name="columns" type="array">
  Column definitions
</ResponseField>

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

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp
</ResponseField>

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

<ResponseExample>
  ```json Success theme={null}
  {
    "id": "tbl_abc123xyz789",
    "name": "leads",
    "description": "Sales prospects",
    "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"
  }
  ```

  ```json Error theme={null}
  {
    "error": {
      "message": "Table not found"
    }
  }
  ```
</ResponseExample>