# Usage

## `GET /v1/usage` (key required) / session

Your plan limits and live usage.

```json
{ "success": true, "plan": "pro",
  "limits": { "per_min": 300, "per_day": 100000, "history_years": null, "credits": null },
  "usage": { "minute_used": 21, "minute_remaining": 279, "day_used": 21,
             "day_remaining": 99979, "credits_remaining": null } }
```

| Field | Meaning |
|---|---|
| `limits.history_years` | Your history window: `1` (Free), `10` (Developer), `null` = full |
| `limits.credits` | The plan's monthly allowance (`500` on Free, `null` on paid plans) |
| `usage.minute_used` | Requests in the last 60 seconds (sliding window) |
| `usage.day_used` | Requests today |
| `usage.credits_remaining` | Free plan only: calls left this month. At `0`, data requests return `402 credits_exhausted` until the reset |
| `usage.credits_reset` | Free plan only: the date the allowance refills (the 1st of next month) |

On the Free plan, a call to `/v1/usage` itself counts as one call.

## `GET /v1/usage/history` (key required) / session

Daily request counts for the last 30 days, which feed the dashboard chart:

```json
{ "success": true, "count": 1, "data": [ { "day": "2026-09-24", "requests": 21 } ] }
```

---
Source: https://pakdatahub.com/docs/api-usage - PakDataHub docs index: https://pakdatahub.com/docs/llms.txt