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

# List Groups



## OpenAPI

````yaml /openapi.json get /v1/workspaces/{workspaceId}/projects/groups
openapi: 3.1.0
info:
  title: Specurate API
  description: ''
  version: 1.0.0
  contact: {}
servers:
  - url: https://app.specurate.com/api
    description: API Server
security: []
tags: []
paths:
  /v1/workspaces/{workspaceId}/projects/groups:
    get:
      tags:
        - Projects
      summary: List Groups
      operationId: ProjectsController_listGroups_v1
      parameters:
        - name: workspaceId
          required: true
          in: path
          schema:
            type: string
        - name: cursor
          required: false
          in: query
          schema:
            type: string
        - name: filter
          required: false
          in: query
          schema:
            default: all
            type: string
            enum:
              - all
              - last-viewed
        - name: isPrototype
          required: false
          in: query
          schema:
            type: boolean
        - name: search
          required: false
          in: query
          schema:
            type: string
            maxLength: 255
        - name: status
          required: false
          in: query
          schema:
            enum:
              - active
              - archived
            type: string
        - name: lifecycleStatus
          required: false
          in: query
          schema:
            type: string
        - name: sector
          required: false
          in: query
          schema:
            type: string
        - name: workType
          required: false
          in: query
          schema:
            type: string
        - name: region
          required: false
          in: query
          schema:
            enum:
              - north_america
              - east_coast
              - west_coast
              - europe
              - middle_east
              - latin_america
              - apac
            type: string
        - name: specDisciplines
          required: false
          in: query
          schema:
            type: array
            uniqueItems: true
            items:
              type: string
              enum:
                - architectural
                - finishes
                - ffe
                - ose
        - name: tagIds
          required: false
          in: query
          schema:
            maxItems: 100
            uniqueItems: true
            type: array
            items:
              type: string
        - name: projectLeadId
          required: false
          in: query
          schema:
            type: string
        - name: unassignedLead
          required: false
          in: query
          schema:
            type: boolean
        - name: plannedStartFrom
          required: false
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - name: plannedStartTo
          required: false
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - name: targetEndFrom
          required: false
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - name: targetEndTo
          required: false
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - name: groupBy
          required: true
          in: query
          schema:
            type: string
            enum:
              - lifecycleStatus
              - sector
              - workType
              - projectLead
        - name: limit
          required: true
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 20
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectGroupsResponseDto'
components:
  schemas:
    ProjectGroupsResponseDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ProjectGroupResponseDto'
        nextCursor:
          type: string
          nullable: true
        hasMore:
          type: boolean
      required:
        - items
        - nextCursor
        - hasMore
    ProjectGroupResponseDto:
      type: object
      properties:
        value:
          type: string
          nullable: true
        count:
          type: number
        lead:
          nullable: true
          type: object
          allOf:
            - $ref: '#/components/schemas/ProjectLeadResponseDto'
      required:
        - value
        - count
        - lead
    ProjectLeadResponseDto:
      type: object
      properties:
        userId:
          type: string
        email:
          type: string
        firstName:
          type: string
          nullable: true
        lastName:
          type: string
          nullable: true
      required:
        - userId
        - email
        - firstName
        - lastName

````