---
title: "Get usage metric history; optional scale=daily or scale=monthly returns only that series"
method: GET
path: "/api/v1/usage/history"
tags: ["Usage Metrics"]
---

# Get usage metric history; optional scale=daily or scale=monthly returns only that series

`GET /api/v1/usage/history`

## Request

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

## Query parameters

- `crewIds` string
- `endDate` string
- `metricKeys` string
- `scale` string
- `startDate` string

## Response `200`

OK

- UsageMetricHistoryResponse
  - `scopeType` string
  - `scopeCustomerId` integer
  - `crewIds` integer[]
  - `series` UsageMetricHistorySeries[]
    - `metricKey` string
    - `metricLabel` string
    - `total` number
    - `daily` UsageMetricHistoryPoint[]
      - `date` string
      - `value` number
    - `monthly` UsageMetricHistoryPoint[]
      - `date` string
      - `value` number

---

[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)