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

# List reports

> Lists completed AI Coach reports visible to a workspace-scoped API key.

List the reports in a deployment, scoped to the reports the calling user can access.

Results are returned in pages using cursor-based pagination: pass `first` to set the page size and `after` (the previous response's `pageInfo.endCursor`) to fetch the next page.

Cursor pagination is not supported when sorting by `lastViewedAt` (a per-viewer sort with no stable cursor column).


## OpenAPI

````yaml /public-v1.json get /workspaces/{workspaceId}/reports
openapi: 3.0.3
info:
  title: Triple Session Public API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://triplesession.com/terms-of-service
  description: >
    Public API v1 exposes AI Coach report data from the legacy Pages API.

    Workspace report endpoints authenticate with a workspace public API key sent
    as a bearer token.
servers:
  - url: https://app.triplesession.com/api/public/ai-coach
    description: Production
security: []
tags:
  - name: Reports
    description: AI Coach report data and artifacts.
paths:
  /workspaces/{workspaceId}/reports:
    get:
      tags:
        - Reports
      summary: List reports
      description: Lists completed AI Coach reports visible to a workspace-scoped API key.
      operationId: listReports
      parameters:
        - $ref: '#/components/parameters/WorkspaceId'
        - $ref: '#/components/parameters/Page'
        - $ref: '#/components/parameters/ReportsLimit'
        - $ref: '#/components/parameters/Search'
        - $ref: '#/components/parameters/ScorecardIdQuery'
      responses:
        '200':
          description: Reports visible to the workspace API key.
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
            X-RateLimit-Active-Window:
              $ref: '#/components/headers/XRateLimitActiveWindow'
            X-RateLimit-Minute-Limit:
              $ref: '#/components/headers/XRateLimitMinuteLimit'
            X-RateLimit-Minute-Remaining:
              $ref: '#/components/headers/XRateLimitMinuteRemaining'
            X-RateLimit-Minute-Reset:
              $ref: '#/components/headers/XRateLimitMinuteReset'
            X-RateLimit-Hour-Limit:
              $ref: '#/components/headers/XRateLimitHourLimit'
            X-RateLimit-Hour-Remaining:
              $ref: '#/components/headers/XRateLimitHourRemaining'
            X-RateLimit-Hour-Reset:
              $ref: '#/components/headers/XRateLimitHourReset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportsListResponse'
        '400':
          description: Invalid search parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportsListErrorResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportsListErrorResponse'
      security:
        - workspaceApiKey: []
components:
  parameters:
    WorkspaceId:
      name: workspaceId
      in: path
      required: true
      description: Workspace ID.
      schema:
        type: string
        format: uuid
    Page:
      name: page
      in: query
      required: false
      description: Page number. Missing, invalid, or values below 1 are treated as page 1.
      schema:
        type: integer
        minimum: 1
        default: 1
    ReportsLimit:
      name: limit
      in: query
      required: false
      description: Number of reports to return. Values are clamped between 1 and 50.
      schema:
        type: integer
        minimum: 1
        maximum: 50
        default: 50
    Search:
      name: search
      in: query
      required: false
      description: >-
        Search text used to filter reports by name, evaluatee, attendee email,
        or CRM deal name. Values over 100 characters are rejected.
      schema:
        type: string
        minLength: 1
        maxLength: 100
    ScorecardIdQuery:
      name: scorecardId
      in: query
      required: false
      description: Filter reports by scorecard ID.
      schema:
        type: string
        format: uuid
  headers:
    XRateLimitLimit:
      description: Limit for the active rate limit window.
      schema:
        type: integer
    XRateLimitRemaining:
      description: Requests remaining in the active rate limit window.
      schema:
        type: integer
    XRateLimitReset:
      description: Unix timestamp when the active rate limit window resets.
      schema:
        type: integer
    XRateLimitActiveWindow:
      description: Active rate limit window.
      schema:
        type: string
        enum:
          - minute
          - hour
    XRateLimitMinuteLimit:
      description: Limit for the minute rate limit window.
      schema:
        type: integer
    XRateLimitMinuteRemaining:
      description: Requests remaining in the minute rate limit window.
      schema:
        type: integer
    XRateLimitMinuteReset:
      description: Unix timestamp when the minute rate limit window resets.
      schema:
        type: integer
    XRateLimitHourLimit:
      description: Limit for the hour rate limit window.
      schema:
        type: integer
    XRateLimitHourRemaining:
      description: Requests remaining in the hour rate limit window.
      schema:
        type: integer
    XRateLimitHourReset:
      description: Unix timestamp when the hour rate limit window resets.
      schema:
        type: integer
    RetryAfter:
      description: Seconds until the request may be retried.
      schema:
        type: integer
  schemas:
    ReportsListResponse:
      type: object
      required:
        - reports
        - page
        - total_count
      properties:
        reports:
          type: array
          items:
            $ref: '#/components/schemas/Report'
        page:
          type: integer
          minimum: 1
        total_count:
          type: integer
          minimum: 0
      additionalProperties: false
    ReportsListErrorResponse:
      type: object
      required:
        - reports
        - error
      properties:
        reports:
          type: array
          items:
            $ref: '#/components/schemas/Report'
        error:
          type: string
      additionalProperties: false
    Report:
      type: object
      required:
        - id
        - name
        - owner_id
        - score
        - score_breakdown
        - scorecard
        - scorecard_id
        - created_at
        - duration_in_minutes
        - source
        - status
        - evaluatee_user
      properties:
        id:
          type: string
        name:
          type: string
        owner_id:
          type: string
        score:
          type: number
        score_breakdown:
          type: object
          additionalProperties:
            type: number
        scorecard:
          type: string
        scorecard_id:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        duration_in_minutes:
          type: number
          nullable: true
        source:
          type: string
          nullable: true
        status:
          type: string
        evaluatee_user:
          $ref: '#/components/schemas/ReportEvaluateeUser'
        share:
          $ref: '#/components/schemas/ReportShare'
        participants:
          type: array
          items:
            type: string
        attendees:
          type: array
          items:
            type: string
        crm_deals:
          type: array
          items:
            $ref: '#/components/schemas/ReportCrmDeal'
      additionalProperties: false
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
      additionalProperties: false
    ReportEvaluateeUser:
      type: object
      required:
        - name
        - first_name
        - email
      properties:
        id:
          type: string
        name:
          type: string
        first_name:
          type: string
        email:
          type: string
          format: email
        avatar_url:
          type: string
          nullable: true
      additionalProperties: false
    ReportShare:
      type: object
      required:
        - id
      properties:
        id:
          type: string
        deactivated_at:
          type: string
          format: date-time
          nullable: true
      additionalProperties: false
    ReportCrmDeal:
      type: object
      required:
        - id
        - name
        - url
      properties:
        id:
          type: string
        name:
          type: string
        url:
          type: string
          nullable: true
      additionalProperties: false
  responses:
    Unauthorized:
      description: Missing or invalid bearer authentication.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: Missing, deprecated, or unauthorized API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    RateLimited:
      description: Rate limit exceeded.
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        X-RateLimit-Limit:
          $ref: '#/components/headers/XRateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/XRateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/XRateLimitReset'
        X-RateLimit-Active-Window:
          $ref: '#/components/headers/XRateLimitActiveWindow'
        X-RateLimit-Minute-Limit:
          $ref: '#/components/headers/XRateLimitMinuteLimit'
        X-RateLimit-Minute-Remaining:
          $ref: '#/components/headers/XRateLimitMinuteRemaining'
        X-RateLimit-Minute-Reset:
          $ref: '#/components/headers/XRateLimitMinuteReset'
        X-RateLimit-Hour-Limit:
          $ref: '#/components/headers/XRateLimitHourLimit'
        X-RateLimit-Hour-Remaining:
          $ref: '#/components/headers/XRateLimitHourRemaining'
        X-RateLimit-Hour-Reset:
          $ref: '#/components/headers/XRateLimitHourReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    workspaceApiKey:
      type: http
      scheme: bearer
      bearerFormat: Workspace API key
      description: Use the public API key generated for a workspace.

````