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

# Get List of Spaces

> Retrieves a paginated list of spaces accessible to the authenticated user. Supports filtering by title and pagination with offset/limit parameters.



## OpenAPI

````yaml api-reference/openapi.json get /api/v1/integration/spaces
openapi: 3.1.0
info:
  title: Thesis.io APIs
  description: >-
    Thesis.io provides comprehensive AI-powered research and conversation APIs
    for DeFi analysis and blockchain research. Create conversations with
    customizable research modes including chat, deep research, and specialized
    DeFi tools for real-time market analysis. Join existing conversations via
    streaming endpoints to participate in collaborative research sessions with
    advanced AI agents.
  version: 0.32.1
servers:
  - url: https://app-be.thesis.io
    description: Production Thesis APIs
security:
  - APIKeyAuth: []
  - {}
paths:
  /api/v1/integration/spaces:
    get:
      tags:
        - spaces
        - spaces
      summary: Get List of Spaces
      description: >-
        Retrieves a paginated list of spaces accessible to the authenticated
        user. Supports filtering by title and pagination with offset/limit
        parameters.
      operationId: get_list_space_api_v1_integration_spaces_get
      parameters:
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 0
            title: Offset
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 10
            title: Limit
        - name: title
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Title
      responses:
        '200':
          description: Spaces retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpaceListResponse'
        '400':
          description: Invalid request data or missing required fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpaceErrorResponse'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/openhands__server__routes__integration__space__FastAPIUnauthorizedErrorResponse
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastAPIResourceNotFoundErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastAPIErrorResponse'
      x-codeSamples:
        - lang: bash
          label: Get list of spaces
          source: >-
            curl -X GET
            'https://app-be.thesis.io/api/v1/integration/spaces?offset=0&limit=10&title=AI%20Research'
            \
              -H 'Authorization: Bearer YOUR_SPACE_API_TOKEN'
        - lang: python
          label: Get list of spaces
          source: |-
            import requests

            url = 'https://app-be.thesis.io/api/v1/integration/spaces'
            headers = {
                'Authorization': 'Bearer YOUR_SPACE_API_TOKEN'
            }
            params = {
                'offset': 0,
                'limit': 10,
                'title': 'AI Research'
            }

            response = requests.get(url, headers=headers, params=params)
            print(response.json())
        - lang: typescript
          label: Get list of spaces
          source: >-
            const params = new URLSearchParams({
              offset: '0',
              limit: '10',
              title: 'AI Research'
            });


            const response = await
            fetch(`https://app-be.thesis.io/api/v1/integration/spaces?${params}`,
            {
              method: 'GET',
              headers: {
                'Authorization': 'Bearer YOUR_SPACE_API_TOKEN'
              }
            });


            const data = await response.json();

            console.log(data);
components:
  schemas:
    SpaceListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/SpaceListItem'
          type: array
          title: Data
          description: List of spaces matching the request
          default: []
        pagination:
          anyOf:
            - $ref: '#/components/schemas/PaginationInfo'
            - type: 'null'
          description: Pagination information for the results
        status:
          type: string
          title: Status
          description: Response status message
          example: Get list spaces success
      type: object
      required:
        - status
      title: SpaceListResponse
    SpaceErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error details from FastAPI
          example: Invalid request data or missing required fields
      type: object
      required:
        - detail
      title: SpaceErrorResponse
    openhands__server__routes__integration__space__FastAPIUnauthorizedErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error details from FastAPI
          example: Unauthorized
      type: object
      required:
        - detail
      title: FastAPIUnauthorizedErrorResponse
    FastAPIResourceNotFoundErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error details from FastAPI
          example: Resource not found
      type: object
      required:
        - detail
      title: FastAPIResourceNotFoundErrorResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FastAPIErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error details from FastAPI
          example: Internal server error
      type: object
      required:
        - detail
      title: FastAPIErrorResponse
    SpaceListItem:
      properties:
        id:
          type: string
          title: Id
          description: Unique identifier for the member
          example: '1587'
        spaceId:
          type: string
          title: Spaceid
          description: Space ID
          example: '868'
        userId:
          type: string
          title: Userid
          description: User ID
          example: '220'
        role:
          anyOf:
            - type: integer
            - type: 'null'
          title: Role
          description: Member role
          example: 1
        status:
          anyOf:
            - type: integer
            - type: 'null'
          title: Status
          description: Member status
          example: 1
        createdAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Createdat
          description: Creation timestamp
          example: '2025-09-10T07:51:19.525Z'
        updatedAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Updatedat
          description: Update timestamp
          example: '2025-09-10T07:51:19.525Z'
        space:
          anyOf:
            - $ref: '#/components/schemas/Space'
            - type: 'null'
          description: Space details
        user:
          anyOf:
            - $ref: '#/components/schemas/User'
            - type: 'null'
          description: User details
      type: object
      required:
        - id
        - spaceId
        - userId
      title: SpaceListItem
    PaginationInfo:
      properties:
        offset:
          anyOf:
            - type: integer
            - type: 'null'
          title: Offset
          description: Number of records skipped
          example: 0
        limit:
          anyOf:
            - type: integer
            - type: 'null'
          title: Limit
          description: Maximum number of records returned
          example: 10
        total:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total
          description: Total number of available records
          example: 25
        has_more:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has More
          description: Whether more records are available
          example: true
      type: object
      title: PaginationInfo
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    Space:
      properties:
        id:
          type: string
          title: Id
          description: Space ID
          example: '868'
        userId:
          type: string
          title: Userid
          description: User ID
          example: '220'
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
          description: Space title
          example: New Space
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Space description
          example: ''
        datasetId:
          anyOf:
            - type: string
            - type: 'null'
          title: Datasetid
          description: Dataset ID
          example: '1234567890'
        datasetName:
          anyOf:
            - type: string
            - type: 'null'
          title: Datasetname
          description: Dataset name
          example: 220-1234567890
        emoji:
          anyOf:
            - type: string
            - type: 'null'
          title: Emoji
          description: Space emoji
          example: ''
        customInstruction:
          anyOf:
            - type: string
            - type: 'null'
          title: Custominstruction
          description: Custom instruction
          example: ''
        category:
          anyOf:
            - type: string
            - type: 'null'
          title: Category
          description: Space category
          example: other
        status:
          anyOf:
            - type: integer
            - type: 'null'
          title: Status
          description: Space status
          example: 1
        visibility:
          anyOf:
            - type: integer
            - type: 'null'
          title: Visibility
          description: Space visibility
          example: 0
        memberCount:
          anyOf:
            - type: integer
            - type: 'null'
          title: Membercount
          description: Member count
          example: 1
        followerCount:
          anyOf:
            - type: integer
            - type: 'null'
          title: Followercount
          description: Follower count
          example: 0
        popularityScore:
          anyOf:
            - type: integer
            - type: 'null'
          title: Popularityscore
          description: Popularity score
          example: 0
        lastActivityAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Lastactivityat
          description: Last activity timestamp
          example: '2025-09-10T07:51:19.519Z'
        createdAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Createdat
          description: Creation timestamp
          example: '2025-09-10T07:51:19.519Z'
        updatedAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Updatedat
          description: Update timestamp
          example: '2025-09-12T02:21:58.501Z'
        datasetCount:
          anyOf:
            - type: integer
            - type: 'null'
          title: Datasetcount
          description: Dataset count
          example: 0
        totalResearch:
          anyOf:
            - type: integer
            - type: 'null'
          title: Totalresearch
          description: Total research count
          example: 2
        systemPrompt:
          anyOf:
            - type: string
            - type: 'null'
          title: Systemprompt
          description: System prompt
          example: ''
        basicPrompt:
          anyOf:
            - type: string
            - type: 'null'
          title: Basicprompt
          description: Basic prompt
          example: ''
        viewCount:
          anyOf:
            - type: integer
            - type: 'null'
          title: Viewcount
          description: View count
          example: 7
        coverUrl:
          anyOf:
            - type: string
            - type: 'null'
          title: Coverurl
          description: Cover URL
          example: https://pbs.png
        uuid:
          anyOf:
            - type: string
            - type: 'null'
          title: Uuid
          description: Space UUID
          example: THESISSPACE1234567890
        avatarUrl:
          anyOf:
            - type: string
            - type: 'null'
          title: Avatarurl
          description: Avatar URL
        social:
          anyOf:
            - type: string
            - type: 'null'
          title: Social
          description: Social links
        spaceType:
          anyOf:
            - type: string
            - type: 'null'
          title: Spacetype
          description: Space type
        inCampaign:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Incampaign
          description: In campaign
          example: false
        user:
          anyOf:
            - $ref: '#/components/schemas/User'
            - type: 'null'
          description: User details
        telegramGroup:
          anyOf:
            - $ref: '#/components/schemas/TelegramGroup'
            - type: 'null'
          description: Telegram group
      type: object
      required:
        - id
        - userId
      title: Space
    User:
      properties:
        id:
          type: string
          title: Id
          description: User's unique identifier
          example: '220'
        publicAddress:
          anyOf:
            - type: string
            - type: 'null'
          title: Publicaddress
          description: User's public wallet address
          example: '0x1234567890'
        username:
          anyOf:
            - type: string
            - type: 'null'
          title: Username
          description: User's display name
          example: Foo Bar
        avatar:
          anyOf:
            - type: string
            - type: 'null'
          title: Avatar
          description: User's avatar URL
          example: https://pbs.png
        status:
          anyOf:
            - type: integer
            - type: 'null'
          title: Status
          description: User status
          example: 1
        whitelisted:
          anyOf:
            - type: integer
            - type: 'null'
          title: Whitelisted
          description: Whitelist status
          example: 0
        createdAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Createdat
          description: User creation timestamp
          example: '2025-07-11T10:18:14.994Z'
        updatedAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Updatedat
          description: User last update timestamp
          example: '2025-09-10T07:22:22.666Z'
        auth0Id:
          anyOf:
            - type: string
            - type: 'null'
          title: Auth0Id
          description: Auth0 ID
          example: twitter|1234567890
        twitterUsername:
          anyOf:
            - type: string
            - type: 'null'
          title: Twitterusername
          description: Twitter username
          example: foo_bar
      type: object
      required:
        - id
      title: User
    TelegramGroup:
      properties:
        id:
          type: string
          title: Id
          description: Telegram group ID
          example: '180'
        groupTitle:
          anyOf:
            - type: string
            - type: 'null'
          title: Grouptitle
          description: Group title
          example: Space new-space-1234567890
        groupInviteLink:
          anyOf:
            - type: string
            - type: 'null'
          title: Groupinvitelink
          description: Group invite link
          example: https://t.me/+1234567890
        createdAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Createdat
          description: Creation timestamp
          example: '2025-09-10T07:51:19.527Z'
        updatedAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Updatedat
          description: Update timestamp
          example: '2025-09-10T07:51:20.060Z'
        status:
          anyOf:
            - type: integer
            - type: 'null'
          title: Status
          description: Group status
          example: 1
      type: object
      required:
        - id
      title: TelegramGroup
  securitySchemes:
    APIKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Enter your API token in the format: Bearer <your_token_here>'

````