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

# Listen auflisten

> Liste gespeicherte Pharen Hub Listen auf, die der API-Key lesen darf, mit Team-, Such-, Sortier- und Pagination-Filtern, um Listen-UUIDs zu finden.

Gibt gespeicherte Listen zuruck, die die erstellende Person des Keys sehen darf.

<Note>
  Erforderlicher API-Key-Scope: `lists:read`.
</Note>

## Query-Parameter

<ParamField query="team_id" type="string">
  Team-UUID. Fur teambegrenzte Keys erforderlich.
</ParamField>

<ParamField query="ordering" type="string">
  Sortierung. Unterstutzte Felder sind `created_at`, `updated_at`, `name`, `field_count` und `row_count`. Nutze `-` fur absteigend.
</ParamField>

<ParamField query="page" type="integer">
  Seitennummer.
</ParamField>

<ParamField query="page_size" type="integer">
  Anzahl der Listen pro Seite.
</ParamField>

## Antwort

<ResponseField name="count" type="integer">
  Gesamtzahl der passenden Listen.
</ResponseField>

<ResponseField name="results" type="array">
  Listen, die fur den Key sichtbar sind.
</ResponseField>


## OpenAPI

````yaml openapi.json GET /api/lists/
openapi: 3.1.0
info:
  title: Pharen Hub API
  version: 1.0.0
  description: >-
    Scoped REST API for Pharen Hub workspaces, calendars, lists, docs,
    workflows, and agents.
servers:
  - url: '{baseUrl}'
    description: Pharen Hub API base URL
    variables:
      baseUrl:
        default: https://pharen.app
        description: >-
          The Pharen Hub API origin. Keep the default for production, or enter
          another environment such as http://localhost:8000.
security:
  - bearerAuth: []
tags:
  - name: Calendar
    description: Calendar source and event operations.
  - name: Lists
    description: Saved list data and metadata operations.
  - name: Docs
    description: Document and collection operations.
  - name: Workflows
    description: Workflow definition and execution operations.
  - name: Agents
    description: Agent catalog and chat operations.
paths:
  /api/lists/:
    get:
      tags:
        - Lists
      summary: List saved lists
      description: >-
        Fetch list metadata and saved list data available to the API key.
        Requires the `lists:read` scope.
      operationId: listLists
      parameters:
        - name: team_id
          in: query
          description: Team UUID for team-scoped keys.
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: Page number for paginated results.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: per_page
          in: query
          description: Number of results per page.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
      responses:
        '200':
          description: Lists returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedLists'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
components:
  schemas:
    PaginatedLists:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/List'
        total:
          type: integer
        page:
          type: integer
        per_page:
          type: integer
    List:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        team_id:
          type: string
          format: uuid
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: forbidden
            message:
              type: string
              example: This API key does not have the required scope.
            details:
              type: object
              additionalProperties: true
  responses:
    Unauthorized:
      description: The request did not include a valid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: >-
        The API key is valid but does not have the required scope or workspace
        access.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Paste your Pharen API key without the Bearer prefix.
      x-default: phk_your_api_key

````