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

# Usage

> Account usage statistics and API key management.

Returns usage statistics for your account.

This API-key endpoint is read-only. Session-authenticated billing controls live under `GET/PATCH /api/businesses/me/overage-settings`, and invoice visibility lives under `GET /api/businesses/me/invoices`.

<ParamField header="X-NearIQ-Key" type="string" required>
  Your API key from Settings > API Keys
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.neariq.io/api/v1/usage" \
    -H "X-NearIQ-Key: niq_your_key_here"
  ```

  ```javascript JavaScript theme={null}
  const neariq = new NearIQ({ apiKey: 'niq_your_key_here' })
  const usage = await neariq.usage.get()
  ```
</RequestExample>

```json theme={null}
{
  "plan": "agency",
  "competitors": { "used": 12, "limit": 50 },
  "rankChecks": { "todayUsed": 8, "dailyLimit": 50 },
  "api": {
    "requestsToday": 142,
    "dailyLimit": 10000,
    "requestsThisMonth": 3841
  },
  "keys": [
    {
      "id": "key_abc",
      "name": "Reporting dashboard",
      "prefix": "niq_a3f7...",
      "createdAt": "2026-01-15T10:00:00Z",
      "lastUsedAt": "2026-04-27T09:22:14Z"
    }
  ]
}
```