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

# Get Usage

> Retrieve your account usage statistics

# Get Usage

Retrieve aggregate usage statistics for your account, including total tasks created and credits consumed.

## Request

```
GET /api/v1/account/usage
```

### Headers

<ParamField header="x-api-key" type="string" required>
  Your API key.
</ParamField>

## Response

<ResponseField name="code" type="number">
  HTTP status code (`200` on success).
</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="tasks_created" type="number">
    Total number of tasks you have created (all statuses).
  </ResponseField>

  <ResponseField name="credits_used" type="number">
    Total credits consumed by all tasks.
  </ResponseField>

  <ResponseField name="credits_topped_up" type="number">
    Total credits added to your account via top-ups.
  </ResponseField>
</ResponseField>

## Example response

```json 200 theme={null}
{
  "code": 200,
  "data": {
    "tasks_created": 42,
    "credits_used": 350,
    "credits_topped_up": 1000
  }
}
```

## Code examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://sunor.cc/api/v1/account/usage \
    -H "x-api-key: YOUR_API_KEY"
  ```

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

  response = requests.get(
      "https://sunor.cc/api/v1/account/usage",
      headers={"x-api-key": "YOUR_API_KEY"},
  )
  usage = response.json()["data"]
  print(f"Tasks created: {usage['tasks_created']}")
  print(f"Credits used: {usage['credits_used']}")
  print(f"Credits topped up: {usage['credits_topped_up']}")
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://sunor.cc/api/v1/account/usage", {
    headers: { "x-api-key": "YOUR_API_KEY" },
  });
  const { data } = await response.json();
  console.log(`Tasks created: ${data.tasks_created}`);
  console.log(`Credits used: ${data.credits_used}`);
  console.log(`Credits topped up: ${data.credits_topped_up}`);
  ```
</CodeGroup>

## Errors

| Status | Description                |
| ------ | -------------------------- |
| `401`  | Missing or invalid API key |
| `500`  | Internal server error      |