---
title: "Get API key statistics"
method: GET
path: "/api/api-keys/{id}/stats"
tags: ["API Keys"]
---

# Get API key statistics

`GET /api/api-keys/{id}/stats`

## Request

- Base URL: `https://api.zvid.io`
- URL: `https://api.zvid.io/api/api-keys/{id}/stats`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Retrieve usage statistics for a specific API key, based on audit logs, for a given timeframe

## Path parameters

- `id` integer, required

## Query parameters

- `timeframe` '24h' | '7d' | '30d'

## Response `200`

API key statistics retrieved successfully

- ApiKeyStats
  - `timeframe` '24h' | '7d' | '30d', required
  - `summary` object, required: Aggregated statistics for the selected timeframe
    - `totalRequests` integer, required
    - `successfulRequests` integer, required
    - `failedRequests` integer, required
    - `avgResponseTime` number
  - `dailyStats` object[]: Daily request breakdown over the last 30 days
    - `date` string, date, required
    - `requests` integer, required
    - `successful` integer, required
    - `failed` integer, required

## Other responses

- `401`: Unauthorized
- `500`: Internal server error

---

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