Docs
API Reference

Usage

List recent usage records and totals for only the returned rows.

GET /v1/usage

Returns recent usage records for the authenticated account. It does not provide cursor, date-range, or provider filtering.

Examples

1curl 'https://qufas-ai.vercel.app/v1/usage?limit=25' \2  -H "Authorization: Bearer $QUFAS_API_KEY"

Limit

limit is clamped to 1–500 by the API. SDK helpers validate their documented range before sending a request.

Records and totals

Totals summarize only the rows returned by the current request. They are not account lifetime totals or full-period totals.

200 JSON
1{2  "object": "list",3  "data": [4    {5      "id": "00000000-0000-0000-0000-000000000000",6      "date": "2026-08-09T00:00:00Z",7      "model": "kimi-k2.7-code",8      "requests": 1,9      "input_tokens": 12,10      "output_tokens": 8,11      "total_tokens": 20,12      "cost": 0.000113    }14  ],15  "totals": {16    "requests": 1,17    "input_tokens": 12,18    "output_tokens": 8,19    "total_tokens": 20,20    "cost": 0.000121  }22}

Was this page helpful?