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

# GET /usage

> Retrieve all-time usage statistics for your organisation

## Endpoint

```
GET https://lyrcs.ai/api/v1/usage
```

Returns job counts, total audio duration processed, a breakdown by language, and total API call count for your organisation.

## Response

```json theme={null}
{
  "org_id": "org_abc123",
  "period": "all_time",
  "total_jobs": 142,
  "completed_jobs": 138,
  "total_duration_seconds": 49320,
  "jobs_by_language": {
    "Hindi": 58,
    "Tamil": 44,
    "Telugu": 22,
    "Punjabi": 18
  },
  "api_calls": 612
}
```

## Response fields

| Field                    | Type   | Description                                       |
| ------------------------ | ------ | ------------------------------------------------- |
| `org_id`                 | string | Your organisation ID                              |
| `period`                 | string | Always `"all_time"` — no date filtering currently |
| `total_jobs`             | number | Total jobs submitted via API                      |
| `completed_jobs`         | number | Jobs where both transcript and LRC are present    |
| `total_duration_seconds` | number | Sum of audio duration across all API jobs         |
| `jobs_by_language`       | object | Job count keyed by language name                  |
| `api_calls`              | number | Total API requests made by this organisation      |

## Examples

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

  ```javascript Node.js theme={null}
  const res = await fetch("https://lyrcs.ai/api/v1/usage", {
    headers: { Authorization: `Bearer ${process.env.LYRCS_API_KEY}` },
  });
  const usage = await res.json();

  const hours = (usage.total_duration_seconds / 3600).toFixed(1);
  console.log(`Processed ${hours} hours of audio`);
  console.log(`Success rate: ${((usage.completed_jobs / usage.total_jobs) * 100).toFixed(1)}%`);
  ```

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

  r = requests.get(
      "https://lyrcs.ai/api/v1/usage",
      headers={"Authorization": f"Bearer {os.environ['LYRCS_API_KEY']}"},
  )
  usage = r.json()

  hours = usage["total_duration_seconds"] / 3600
  print(f"Processed {hours:.1f} hours of audio")
  ```
</CodeGroup>