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

> Retrieve a paginated list of your product schemas.

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

## Response

<ResponseField name="data" type="array">
  <Expandable title="Schema summary object">
    <ResponseField name="id" type="string">Unique schema identifier.</ResponseField>
    <ResponseField name="name" type="string">Schema name.</ResponseField>
    <ResponseField name="description" type="string | null">Schema description.</ResponseField>
    <ResponseField name="is_default" type="boolean">Whether this is the default schema.</ResponseField>
    <ResponseField name="columns_count" type="integer">Number of columns defined.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
    <ResponseField name="updated_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 schemas.</ResponseField>
  </Expandable>
</ResponseField>

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

  for (const schema of result.data) {
    console.log(`${schema.name} (${schema.columns_count} columns)`);
  }
  ```

  ```python Python theme={null}
  result = client.schemas.list(page=1, limit=10)

  for schema in result["data"]:
      print(f"{schema['name']} ({schema['columns_count']} columns)")
  ```

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

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "schema_abc123",
        "name": "Electronics Catalog",
        "description": "Schema for consumer electronics",
        "is_default": false,
        "columns_count": 6,
        "created_at": "2025-03-01T10:00:00.000Z",
        "updated_at": "2025-03-05T12:00:00.000Z"
      }
    ],
    "pagination": { "page": 1, "limit": 10, "total": 4 }
  }
  ```
</ResponseExample>