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

# List Spaces

> List all accessible spaces with pagination. Folders reference their space via space_id.



## OpenAPI

````yaml GET /v1/spaces
openapi: 3.1.0
info:
  title: Granola API
  version: 1.0.0
  description: API for accessing meeting data from Granola
servers:
  - url: https://public-api.granola.ai
    description: Production
security: []
paths:
  /v1/spaces:
    get:
      summary: List spaces
      parameters:
        - schema:
            type: string
            description: The cursor to continue from
            example: eyJjcmVkZW50aWFsfQ==
          required: false
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 30
            default: 10
            description: The number of spaces to return
            example: 10
          required: false
          name: page_size
          in: query
      responses:
        '200':
          description: List of spaces
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSpacesOutput'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid API key
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ListSpacesOutput:
      type: object
      properties:
        spaces:
          type: array
          items:
            $ref: '#/components/schemas/Space'
        hasMore:
          type: boolean
          description: Whether there are more spaces to fetch
          example: true
        cursor:
          type:
            - string
            - 'null'
          description: The cursor to continue from
          example: eyJjcmVkZW50aWFsfQ==
      required:
        - spaces
        - hasMore
        - cursor
    Space:
      type: object
      properties:
        id:
          type: string
          pattern: ^spa_[a-zA-Z0-9]{14}$
          description: The ID of the space
          example: spa_8kTq2mWxLp4Rz7
        object:
          type: string
          enum:
            - space
        name:
          type: string
          description: The name of the space
          example: Product team
      required:
        - id
        - object
        - name
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.