---
title: "List usage reports visible to the API key"
method: GET
path: "/api/v1/reports"
tags: ["Usage Reports"]
---

# List usage reports visible to the API key

`GET /api/v1/reports`

## Request

- Base URL: `https://brew.marketbrew.ai/api/v1`
- URL: `https://brew.marketbrew.ai/api/v1/api/v1/reports`
- Auth: API key in header `API-Key`

## Response `200`

OK

- UsageReportListResponse
  - `reports` UsageReportDefinition[]
    - `id` string
    - `name` string
    - `scopeType` string
    - `ownerCustomerId` integer
    - `crewIds` integer[]
    - `metricKeys` string[]
    - `emailRecipients` string[]
    - `emailSubject` string
    - `weeklyEmailDay` integer
    - `weeklyEmailHour` integer
    - `defaultReport` boolean

---

[API](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation.md) · [All operations](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/revisions/11e3674a43d7?raw)