Usage History

Endpoint

GET/usage/history

Get detailed model-by-model, day-by-day usage with associated pricing.

---

Request

Query parameters

Parameter	Type	Required	Description
month	integer		Month number (1-12). Defaults to current month
year	integer		Year. Defaults to current year

Examples

Current month:

curl \
  -H "Authorization: Bearer $IG1AI_API_KEY" \
  https://api.ig1.ai/usage/history

Specific month (June 2026):

curl \
  -H "Authorization: Bearer $IG1AI_API_KEY" \
  "https://api.ig1.ai/usage/history?month=6&year=2026"

---

Response

{
  "kimi-k26-instant": [
    {
      "year": 2026,
      "month": 6,
      "day": 3,
      "input_tokens": 199,
      "input_token_cost": 0.000012,
      "output_tokens": 3820,
      "output_token_cost": 0.00005
    }
  ],
  "qwen-image": [
    {
      "year": 2026,
      "month": 6,
      "day": 3,
      "input_tokens": 0,
      "input_token_cost": 0,
      "output_tokens": 221184000,
      "output_token_cost": 2e-9
    }
  ]
}

Response fields (per day entry)

Field	Type	Description
year	integer	Year
month	integer	Month
day	integer	Day
input_tokens	integer	Input tokens consumed
input_token_cost	float	Cost per input token
output_tokens	integer	Output tokens consumed
output_token_cost	float	Cost per output token