Usage API - Forii — India's Sovereign Inference Platform

Query your token usage and costs programmatically. All costs in INR.

Get usage

GET /v1/accounts/{account_id}/usage?start=2025-01-01&end=2025-01-31&group_by=model
Authorization: Bearer $FORII_API_KEY

Parameters

Parameter	Type	Required	Description
`start`	string (ISO date)	Yes	Start date (inclusive)
`end`	string (ISO date)	Yes	End date (inclusive)
`group_by`	string	No	`model` (default), `key`, `day`

Response

{
  "data": [
    {
      "date": "2025-01-15",
      "model": "forii/deepseek-v3",
      "prompt_tokens": 1250000,
      "completion_tokens": 340000,
      "total_tokens": 1590000,
      "cost_inr": 531.50
    },
    {
      "date": "2025-01-15",
      "model": "forii/embed-v3",
      "prompt_tokens": 800000,
      "total_tokens": 800000,
      "cost_inr": 24.00
    }
  ]
}

All costs in INR. This is an India differentiator — no USD conversion needed.

Group by API key

GET /v1/accounts/{account_id}/usage?group_by=key
Authorization: Bearer $FORII_API_KEY

Break down usage per API key for multi-team cost attribution.

Observability Overview — Available and upcoming observability features
Dashboard — Usage in the UI
Pricing — Model pricing details