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

# List tables

> Retrieve a paginated list of your extraction tables.

## Query parameters

<ParamField query="page" type="integer" default="1">
  Page number for pagination.
</ParamField>

<ParamField query="limit" type="integer" default="25">
  Number of items per page (max 100).
</ParamField>

<ParamField query="search" type="string">
  Filter tables by name (case-insensitive partial match).
</ParamField>

<ParamField query="status" type="string">
  Filter by job status. Values: `queued`, `processing`, `completed`, `failed`.
</ParamField>

## Response

<ResponseField name="data" type="array">
  <Expandable title="Table summary object">
    <ResponseField name="id" type="string">Unique table identifier.</ResponseField>
    <ResponseField name="name" type="string">Table name.</ResponseField>
    <ResponseField name="status" type="string">Current status: `queued`, `processing`, `completed`, or `failed`.</ResponseField>
    <ResponseField name="total_rows" type="integer">Number of extracted rows.</ResponseField>
    <ResponseField name="schema_id" type="string">The schema used for extraction.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination metadata">
    <ResponseField name="page" type="integer">Current page.</ResponseField>
    <ResponseField name="limit" type="integer">Items per page.</ResponseField>
    <ResponseField name="total" type="integer">Total number of tables.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```typescript TypeScript theme={null}
  const result = await client.tables.list({
    page: 1,
    limit: 10,
    status: "completed",
  });

  console.log(result.data);
  console.log(result.pagination.total);
  ```

  ```python Python theme={null}
  result = client.tables.list(page=1, limit=10, status="completed")

  print(result["data"])
  print(result["pagination"]["total"])
  ```

  ```bash cURL theme={null}
  curl -X GET "https://hub.banditshq.com/api/v1/tables?page=1&limit=10&status=completed" \
    -H "Authorization: Bearer lasso_..."
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "tbl_abc123",
        "name": "Q1 Product Catalog",
        "status": "completed",
        "total_rows": 42,
        "schema_id": "schema_xyz789",
        "created_at": "2025-03-10T14:30:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 3
    }
  }
  ```
</ResponseExample>