---
title: Check Usage
api: GET /auth/usage
description: "Returns your current daily API usage against your tier limits."
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.boringmarketing.com/llms.txt). Append `.md` to any page URL for its markdown version.

Check how many API calls you have used today and how many remain.

## Response

```json
{
  "tier": "solo",
  "calls_today": 42,
  "daily_limit": 500,
  "calls_remaining": 458,
  "brands_used": 1,
  "brand_limit": 1,
  "content_enabled": true
}
```

| Field | Description |
|-------|------------|
| `calls_today` | API calls made since midnight UTC |
| `daily_limit` | Maximum calls allowed per day for your tier |
| `calls_remaining` | Calls left before hitting `402 credits_exhausted` |
| `content_enabled` | Whether brief/execute endpoints are available (always `true` on paid tiers) |

## Example

<CodeGroup>
```bash cURL
curl -H "X-API-Key: $BM_API_KEY" \
  https://api.boringmarketing.com/auth/usage
```

```python Python
usage = httpx.get(
    "https://api.boringmarketing.com/auth/usage",
    headers={"X-API-Key": api_key},
).json()
print(f"{usage['calls_remaining']} calls remaining")
```
</CodeGroup>