---
title: "List"
method: GET
path: "/api/v1/apps/{app_id}/report"
tags: ["App Reports"]
---

# List

`GET /api/v1/apps/{app_id}/report`

Get a list of reports for the given app.

## Path parameters

- `app_id` string, required — The appId field.

## Query parameters

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

## Response `200`

The AppReportServiceListResponse message contains a list of results and a nextPageToken if applicable.

- C1ApiAppV1AppReportServiceListResponse — The AppReportServiceListResponse message contains a list of results and a nextPageToken if applicable.
  - `list` C1ApiAppV1AppPopulationReport[], nullable — The list of results containing up to X results, where X is the page size defined in the request.
    - `appId` string — The appId is the Id of the app which the report is generated for.
    - `createdAt` string, date-time, nullable
    - `downloadUrl` string — The downloadUrl is the url used for downloading the AppPopulationReport.
    - `hashes` object — The hashes field contains the file hashes of the report.
    - `id` string — The id field.
    - `state` 'REPORT_STATE_UNSPECIFIED' | 'REPORT_STATE_PENDING' | 'REPORT_STATE_OK' | 'REPORT_STATE_ERROR' — The state field tracks the state of the AppPopulationReport. This state field can be one of REPORT_STATE_PENDING, REPORT_STATE_UNSPECIFIED, REPORT_STATE_OK, REPORT_STATE_ERROR.
  - `nextPageToken` string — The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retreived. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

## Changes

- **2026-08-21** `f2cf3228f366` — 1 breaking
  - the response property `list/items/createdAt` became nullable for the status `200`
- **2025-04-10** `17f9f3bcedd5` — 5 info
  - api tag `App Reports` added
  - api tag `AppReport` removed
  - added the new optional `query` request parameter `page_size`
  - added the new optional `query` request parameter `page_token`
  - …1 more

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/apps/:app_id/report/get.md)

---

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