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

# Usage API

> Monitor storage, credits, and subscription information for your organization.

## Quick Start

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.cuadra.ai/v1/usage \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

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

  response = httpx.get(
      "https://api.cuadra.ai/v1/usage",
      headers={"Authorization": "Bearer YOUR_TOKEN"}
  )
  usage = response.json()
  print(f"Credits used: {usage['credits']['used']}/{usage['credits']['limit']}")
  ```

  ```typescript Node.js theme={null}
  const response = await fetch('https://api.cuadra.ai/v1/usage', {
    headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
  });
  const usage = await response.json();
  console.log(`Credits used: ${usage.credits.used}/${usage.credits.limit}`);
  ```
</CodeGroup>

***

## Response Overview

```json theme={null}
{
  "storage": {
    "used": 524288000,
    "limit": 1073741824
  },
  "credits": {
    "used": 7500,
    "limit": 50000,
    "available": 42500,
    "billingPeriod": "monthly",
    "periodStart": "2025-12-01T00:00:00Z",
    "periodEnd": "2025-12-31T23:59:59Z"
  },
  "plan": {
    "tier": "pro",
    "name": "Professional",
    "billingCycle": "monthly"
  }
}
```

***

## Role-Based Visibility

| Field                        | All Users | Admins Only |
| ---------------------------- | --------- | ----------- |
| Storage used/limit           | ✅         | ✅           |
| Credits used/limit/available | ✅         | ✅           |
| Plan tier/name               | ✅         | ✅           |
| Purchased balance            | ❌         | ✅           |
| Seat count                   | ❌         | ✅           |
| Credits per seat             | ❌         | ✅           |

***

## Related

<CardGroup cols={2}>
  <Card title="Credits" icon="coins" href="/billing/credits">
    Understanding credits
  </Card>

  <Card title="Pricing" icon="tag" href="https://cuadra.ai/pricing">
    Plans and pricing
  </Card>
</CardGroup>