---
title: "Get usage history over time"
method: GET
path: "/api/v1/usage/history"
tags: ["Usage"]
---

# Get usage history over time

`GET /api/v1/usage/history`

## Request

- Base URL: `https://api.tuteliq.ai`
- URL: `https://api.tuteliq.ai/api/v1/usage/history`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns daily request counts (total, successful, failed) for the past N days (1–30, default 7). Use for trend analysis, usage charts, and identifying peak traffic periods.

## Query parameters

- `days` number

## Response `200`

Default Response

- object
  - `api_key_id` string
  - `days` object[]
    - `date` string
    - `total_requests` number
    - `success_requests` number
    - `error_requests` number

---

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