---
title: "List financial reports"
method: GET
path: "/analytics/reports"
tags: ["Analytics"]
---

# List financial reports

`GET /analytics/reports`

## Request

- Base URL: `https://us.api.flexprice.io/v1`
- URL: `https://us.api.flexprice.io/v1/analytics/reports`
- Auth: API key in header `x-api-key`

Returns the catalog of reports with their allowed shapes, dimensions and grains.

## Response `200`

OK

- ReportCatalogResponse
  - `items` ReportCatalogEntry[]
    - `category` 'billing' | 'receivables' | 'customers' | 'credits' | 'usage'
    - `default_shape` 'timeseries' | 'breakdown' | 'scalar'
    - `description` string
    - `dimensions` ReportDimension[]
      - `key` string
      - `label` string
    - `grains` string[]
    - `improvement` 'higher' | 'lower'
    - `key` string
    - `kind` 'flow' | 'ratio' | 'snapshot'
    - `max_range_days` integer
    - `name` string
    - `shapes` string[]
    - `supports_compare` boolean
    - `value_type` 'money' | 'count' | 'days'
    - `variant_label` string
    - `variant_of` string

## Other responses

- `403`: Reports not enabled
- `500`: Server error

## Changes

- **2026-10-25** `4746c65d9396`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flexprice/apis/flexprice-api/changes/analytics/reports/get.md)

---

[API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [All operations](https://skmtc.dev/flexprice/apis/flexprice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flexprice/apis/flexprice-api/revisions/e1348d61034c?raw)