---
title: "List"
method: GET
path: "/api/v1/reporting/reports"
tags: ["Report"]
---

# List

`GET /api/v1/reporting/reports`

List returns reports created by the caller, newest first.

## Query parameters

- `page_size` integer — The pageSize field.
- `page_token` string — The pageToken field.

## Response `200`

Successful response

- C1ApiReportingV1ReportingServiceListResponse — The ReportingServiceListResponse message.
  - `list` C1ApiReportingV1Report[], nullable — The list field.
    - `createdAt` string, date-time, nullable
    - `createdByUserId` string — The createdByUserId field.
    - `deletedAt` string, date-time, nullable
    - `displayName` string — The displayName field.
    - `id` string — The id field.
    - `latestRunId` string — Separate pointers: the last attempt may have failed while callers still need the last renderable result.
    - `latestSuccessfulRunId` string — The latestSuccessfulRunId field.
    - `parameterSchema` object, nullable
    - `parameterValues` object, nullable
    - `program` C1ApiReportingV1ProgramRef — ProgramRef points at a pinned, executable program.
      - `commitId` string — Code mode invokes by explicit commit, so the commit — not the function — is what a refresh re-executes.
      - `functionId` string — A saved report owns its Function, so this is per-report rather than the shared code-mode scratch function the program first ran on.
      - `plannedFromPrompt` string — 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.
    - `prompt` string — The editable natural-language question. Only a re-plan reads this.
    - `tenantId` string — The tenantId field.
    - `updatedAt` string, date-time, nullable
  - `nextPageToken` string — The nextPageToken field.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)