Endpoint
GET https://lyrcs.ai/api/v1/usage
Response
{
"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
curl https://lyrcs.ai/api/v1/usage \
-H "Authorization: Bearer $LYRCS_API_KEY"
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)}%`);
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")