---
title: "List all reports"
method: GET
path: "/reporting/v2/reports"
tags: ["Reporting V2"]
---

# List all reports

`GET /reporting/v2/reports`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/reporting/v2/reports`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/reporting/v2/reports/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all reports generated from your marketplace.

## Query parameters

- `ownerType` 'ROLE_CHANNEL_ADMIN' | 'ROLE_DEVELOPER' | 'ROLE_RESELLER_MANAGER' | 'ROLE_PARTNER'
- `reportName` string
- `date` string
- `number` integer
- `size` integer
- `searchText` string

## Response `200`

A list of all all reports matching the search criteria

- ReportListingWS: A list of reports
  - `content` ReportWS[]: Report run UUID
    - `createdDate` number: Report creation date
    - `endDate` number: Period end time of the report
    - `filename` string: Report file name
    - `id` number: Report ID
    - `reportType` 'ACTIVE_UNCONVERTED_USERS' | 'APPLICATION_USAGE' | 'CANCELLED_ENTITLEMENTS' | 'COMPANIES_CSV' | 'CONTRACT_TERM' | 'CUSTOMERS_CSV' | 'CUSTOMER_ACQUISITION_BONUS' | 'CUSTOMER_RETENTION_BONUS' | 'FAILED_ORDERS' | 'FAILURE_INTEGRATION_EVENT' | 'FREE_TRIALS' | 'GENERAL_PERFORMANCE_REPORT' | 'INVOICES' | 'INVOICES_CSV' | 'MICROSOFT_RECONCILIATION' | 'MIGRATION_PRODUCT_DATA' | 'MOSI_ACQUISITION_BONUS' | 'MOSI_RETENTION_BONUS' | 'NOT_USED_APP' | 'ORDER_EDITIONS_CSV' | 'ORDER_PRODUCTS_CSV' | 'PAYMENTS_DETAIL_CSV' | 'PAYMENTS_OVERVIEW_CSV' | 'RECONCILIATION' | 'RE_CALCULATE_SUBSCRIPTION_PRICES' | 'SUSPENDED_PURCHASED' | 'TAXES' | 'TRANSACTIONS' | 'VOICE_CONN_CSV'
    - `startDate` number: Period start time of the report
  - `page` PagedResources, nullable: Resource links
    - `links` Link[]: Resource links
      - `href` string
      - `rel` string
    - `page` PageMetadata
      - `number` number, required: Page number
      - `size` number, required: Size of the page to be returned
      - `totalElements` number, required: Total number of elements
      - `totalPages` number, required: Total number of pages

## Other responses

- `400`: Input is invalid or malformed
- `403`: The user identified by the incoming credentials cannot be resolved, or does not have the authorization to view reports of the requested owner type

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/reporting/v2/reports/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)