Balance

curl https://ollama.com/api/balance \
  -H "Authorization: Bearer $OLLAMA_API_KEY"

{
  "included": {
    "balance_usd": 72.5,
    "allowance_usd": 100,
    "period": {
      "from": "2026-09-15T09:30:00Z",
      "until": "2026-10-15T09:30:00Z"
    }
  },
  "purchased": {
    "balance_usd": 25
  }
}

This endpoint takes no query parameters. For usage history, see Cloud usage.

Balances

The included period follows your plan's monthly reset schedule, including for annual subscriptions. Period timestamps are in UTC, with from inclusive and until exclusive.

The purchased balance includes only unexpired credits.

{
  "included": {
    "session": {
      "remaining_percent": 75,
      "resets_at": "2026-10-01T07:00:00Z"
    },
    "weekly": {
      "remaining_percent": 40,
      "resets_at": "2026-10-05T00:00:00Z"
    }
  },
  "purchased": {
    "balance_usd": 25
  }
}

Rate limits

This endpoint allows 10 requests per minute per user, shared across API keys and devices. We recommend polling once per minute. A 429 response includes a Retry-After header with the number of seconds to wait before retrying.

Teams

All team members share the same included and purchased balances.

Reference