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 (December 2025):

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

---

Response

{
  "qwen35-397b-a17b-instruct-general": [
    {
      "year": 2026,
      "month": 3,
      "day": 16,
      "input_tokens": 199,
      "input_tokens_cost": 0.000012,
      "output_tokens": 3820,
      "output_tokens_cost": 0.00005
    }
  ],
  "qwen-image": [
    {
      "year": 2026,
      "month": 3,
      "day": 16,
      "input_tokens": 0,
      "input_tokens_cost": 0,
      "output_tokens": 221184000,
      "output_tokens_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_tokens_cost	float	Cost per input token
output_tokens	integer	Output tokens consumed
output_tokens_cost	float	Cost per output token