---
title: "get_usage_overview"
method: GET
path: "/v1/usage/overview"
tags: ["operations"]
---

# get_usage_overview

`GET /v1/usage/overview`

## Request

- Base URL: `https://ndi-api.nace.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://ndi-api.nace.ai/v1/usage/overview`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/nace/apis/ndi-service/docs/v1/usage/overview/get.ts> (a function with typed inputs; its response is checked against the schema)

Dashboard figures for documents processed, in-flight jobs, and latency.

Cost class: fast. Documents are succeeded document-operation jobs
(parse / split / classify / categorize / extract / ground / qa_file)
finished in the window. Active and queued counts are a point-in-time
snapshot of every job kind. The series is zero-filled so a chart can
plot it without filling gaps.

Args:
    session: Database session.
    caller: The authenticated tenant.
    window: Rolling window ending today (UTC).

Returns:
    Headline figures for the window, the matching prior window, and a
    daily series of documents processed.

## Query parameters

- `window` '7d' | '30d' | '90d': Rolling window ending today (UTC): 7, 30, or 90 days.

## Response `200`

Successful Response

- UsageOverviewResponse: Dashboard figures for a rolling ``7d`` / ``30d`` / ``90d`` window. Prior-period fields are the same-length window immediately before ``period_start``. The frontend derives the percentage / delta; this response only reports the two raw values. Average processing time is ``null`` when the window has no succeeded document-operation jobs.
  - `window` '7d' | '30d' | '90d', required
  - `period_start` string, date, required
  - `period_end` string, date, required
  - `documents_processed` integer, required
  - `documents_processed_prior` integer, required
  - `active_jobs` integer, required
  - `queued_jobs` integer, required
  - `avg_processing_seconds` number, nullable, required
  - `avg_processing_seconds_prior` number, nullable, required
  - `series` UsageOverviewPoint[], required
    - `day` string, date, required
    - `documents` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `410`: Gone
- `413`: Request Entity Too Large
- `422`: Unprocessable Entity
- `424`: Failed Dependency
- `429`: Too Many Requests
- `500`: Internal Server Error
- `501`: Not Implemented
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/nace/apis/ndi-service.md) - [All operations](https://skmtc.dev/nace/apis/ndi-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/ndi-service/revisions/d9d1f8ec2207?raw)