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

# List Projects

> List all projects for the authenticated user.



## OpenAPI

````yaml api/openapi.json GET /v1/projects
openapi: 3.1.0
info:
  title: Connections Hub API
  version: 1.0.0
  description: >-
    Run HSS Connections Hub calculators programmatically: create projects,
    create and solve sheets from any calculator template, run batches, and
    export reports to PDF.


    All endpoints require API key authentication.
servers:
  - url: https://api.calcs.com
security:
  - bearerAuth: []
tags:
  - name: Projects
    description: >-
      Create and manage calculation projects. Each user can have multiple
      projects to organize their calculations.
  - name: Sheets
    description: >-
      Manage individual calculation sheets — read one back, update its inputs,
      solve or re-solve it, and delete single sheets or clean up many at once.
  - name: Templates
    description: >-
      Run calculations using any enabled template. Supports all calculator types
      without requiring endpoint-specific code.
paths:
  /v1/projects:
    get:
      tags:
        - Projects
      summary: List Projects
      description: List all projects for the authenticated user.
      operationId: list-projects
      parameters:
        - name: Authorization
          in: header
          required: true
          example: Bearer YOUR_KEY_HERE
          schema:
            type: string
          description: >-
            The `Authorization` header is used to authenticate with the API
            using your API key. Value is of the format `Bearer YOUR_KEY_HERE`.
        - name: limit
          in: query
          schema:
            type: integer
            default: 25
          description: Number of projects per page
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page number
        - name: state
          in: query
          schema:
            type: string
            enum:
              - active
              - archived
              - deleted
            default: active
          description: Filter by project state
      responses:
        '200':
          description: List of projects
          content:
            application/json:
              schema:
                type: object
                properties:
                  projects:
                    type: array
                    items:
                      type: object
                      properties:
                        projectId:
                          type: string
                          format: uuid
                          description: Unique identifier for the project
                        projectUrl:
                          type: string
                          format: uri
                          description: >-
                            Direct link to the project in the Calcs.com app.
                            Always present on a successful response.
                        name:
                          type: string
                          description: Project name
                      required:
                        - projectId
                        - name
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                        description: Current page number
                      limit:
                        type: integer
                        description: Number of items per page
                      total:
                        type: integer
                        description: Total number of projects
                      hasNext:
                        type: boolean
                        description: Whether there are more pages
                      hasPrev:
                        type: boolean
                        description: Whether there are previous pages
                required:
                  - projects
                  - pagination
              example:
                projects:
                  - projectId: 0ad00c8b-03e9-467c-aa29-27d28f6a056f
                    projectUrl: >-
                      https://app.calcs.com/project/0ad00c8b-03e9-467c-aa29-27d28f6a056f
                    name: Zuplo Test Project
                  - projectId: e206293f-773b-44ae-96ba-b0df6ddb75f6
                    projectUrl: >-
                      https://app.calcs.com/project/e206293f-773b-44ae-96ba-b0df6ddb75f6
                    name: Test Project API
                pagination:
                  page: 1
                  limit: 25
                  total: 2
                  hasNext: false
                  hasPrev: false
        '401':
          description: Unauthorized - invalid or missing API key
      security:
        - api_key: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send your API key as a bearer token: `Authorization: Bearer
        YOUR_API_KEY`. Every endpoint requires one.
    api_key:
      type: http
      scheme: bearer

````

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