> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-lee-tschetter-gemini-enterprise-mcp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List

> List returns reports created by the caller, newest first.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/reporting/reports
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/reporting/reports:
    get:
      tags:
        - Report
      summary: List
      description: List returns reports created by the caller, newest first.
      operationId: c1.api.reporting.v1.ReportingService.List
      parameters:
        - in: query
          name: page_size
          schema:
            description: The pageSize field.
            format: int32
            type: integer
        - in: query
          name: page_token
          schema:
            description: The pageToken field.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.reporting.v1.ReportingServiceListResponse
          description: Successful response
components:
  schemas:
    c1.api.reporting.v1.ReportingServiceListResponse:
      description: The ReportingServiceListResponse message.
      properties:
        list:
          description: The list field.
          items:
            $ref: '#/components/schemas/c1.api.reporting.v1.Report'
          type:
            - array
            - 'null'
        nextPageToken:
          description: The nextPageToken field.
          type: string
      title: Reporting Service List Response
      type: object
      x-speakeasy-name-override: ReportingServiceListResponse
    c1.api.reporting.v1.Report:
      description: >-
        Report is a saved report: the question, the program that answers it, and
        the
         parameters a re-run may vary.
      properties:
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        createdByUserId:
          description: The createdByUserId field.
          type: string
        deletedAt:
          format: date-time
          type:
            - string
            - 'null'
        displayName:
          description: The displayName field.
          type: string
        id:
          description: The id field.
          type: string
        latestRunId:
          description: >-
            Separate pointers: the last attempt may have failed while callers
            still need
             the last renderable result.
          type: string
        latestSuccessfulRunId:
          description: The latestSuccessfulRunId field.
          type: string
        parameterSchema:
          additionalProperties: true
          type:
            - object
            - 'null'
        parameterValues:
          additionalProperties: true
          type:
            - object
            - 'null'
        program:
          oneOf:
            - $ref: '#/components/schemas/c1.api.reporting.v1.ProgramRef'
            - type: 'null'
        prompt:
          description: The editable natural-language question. Only a re-plan reads this.
          type: string
        tenantId:
          description: The tenantId field.
          type: string
        updatedAt:
          format: date-time
          type:
            - string
            - 'null'
      title: Report
      type: object
      x-speakeasy-name-override: Report
    c1.api.reporting.v1.ProgramRef:
      description: ProgramRef points at a pinned, executable program.
      properties:
        commitId:
          description: >-
            Code mode invokes by explicit commit, so the commit — not the
            function — is
             what a refresh re-executes.
          type: string
        functionId:
          description: >-
            A saved report owns its Function, so this is per-report rather than
            the
             shared code-mode scratch function the program first ran on.
          type: string
        plannedFromPrompt:
          description: >-
            The prompt this program was planned from. Report.prompt is editable
            and a
             refresh never re-plans, so this is the only way to detect that a report's
             question has drifted from the program answering it.
          type: string
      title: Program Ref
      type: object
      x-speakeasy-name-override: ProgramRef
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````