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

# List all reports

`GET /reporting/v1/reports`

## Request

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

Lists all reports that are automatically generated on your marketplace.

## Query parameters

- `count` integer
- `fromDate` number
- `start` integer
- `toDate` number
- `type` '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'

## Response `200`

Success

- ReportsWS: Reports information for reporting API
  - `reports` ReportWS[]: List of reports
    - `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
  - `totalCount` number: Total count of reports returned by API

## Changes

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

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/reporting/v1/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)