---
title: "Get usage aggregated by model"
method: GET
path: "/usage/concurrent/by-model"
tags: ["Usage"]
---

# Get usage aggregated by model

`GET /usage/concurrent/by-model`

Get concurrent-capacity usage rolled up per model and region over a date range. Returns aggregated totals instead of daily rows.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `model_id` string
- `region` string

## Headers

- `x-api-key` string, required

## Response `200`

Aggregated usage data by model

- object
  - `customerId` string
  - `from` string, date
  - `to` string, date
  - `items` object[]
    - `modelId` string — Dedicated model route ID
    - `region` string
    - `totalUsageSecondsTimesSize` number — Total GPU-instance-seconds over the date range
    - `totalConcurrencyHours` number — totalUsageSecondsTimesSize / 3600
    - `averageInstancesOverRange` number — Average instance count over the full date range (including days with no usage)
    - `daysWithUsage` integer — Number of distinct days with usage in the range

## Other responses

- `400` — Missing or invalid date range or filters
- `401` — Unauthorized — invalid or missing API key
- `504` — Query timed out — try a smaller date range

## Changes

- **2026-05-20** `702f8648dfd2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/deepdub-ai/apis/deepdub-api/changes/usage/concurrent/by-model/get.md)

---

[API](https://skmtc.dev/deepdub-ai/apis/deepdub-api.md) · [All operations](https://skmtc.dev/deepdub-ai/apis/deepdub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepdub-ai/deepdub-api/revisions/903a930c3849/schema)