> ## Documentation Index
> Fetch the complete documentation index at: https://docs.k-router.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> 잔여 한도 및 사용량 조회

# GET /v1/usage

인증된 사용자의 잔여 한도(USD)와 사용량을 조회합니다.

## 헤더

<ParamField header="Authorization" type="string" required>
  `Bearer kr-your-api-key`
</ParamField>

## 응답

```json 200 - 성공 theme={null}
{
  "credits_remaining": 120.50,
  "credits_used": 29.50,
  "usage_this_month": 12.34,
  "customer": {
    "name": "My Company",
    "credits": 120.50
  },
  "recentUsage": [
    {
      "model": "kr/gpt54",
      "inputTokens": 150,
      "outputTokens": 500,
      "credits": 0.02,
      "createdAt": "2026-03-20T04:00:00.000Z"
    }
  ]
}
```

## 응답 필드

| 필드                  | 타입     | 설명               |
| ------------------- | ------ | ---------------- |
| `credits_remaining` | number | 잔여 한도 (USD)      |
| `credits_used`      | number | 총 사용 금액 (USD)    |
| `usage_this_month`  | number | 이번 달 사용 금액 (USD) |
| `recentUsage`       | array  | 최근 50건 사용 내역     |

<Note>
  모든 금액은 USD 단위로 표시됩니다.
</Note>

## 예시

```bash cURL theme={null}
curl https://api.k-router.com/v1/usage \
  -H "Authorization: Bearer kr-your-api-key"
```

```python Python theme={null}
import requests

r = requests.get(
    "https://api.k-router.com/v1/usage",
    headers={"Authorization": "Bearer kr-your-api-key"}
)
data = r.json()
print(f"잔여 한도: ${data['credits_remaining']}")
print(f"이번 달 사용: ${data['usage_this_month']}")
```