Get Usage

Retrieve your current billing period usage statistics.

GET /api/v1/billing/usage

Authentication

JWT Bearer Token required via Authorization header.

Query Parameters

Parameter	Type	Default	Description
period	string	current	current, previous, or ISO month 2026-03

Response

200 OK

{
  "period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-04-01T00:00:00Z"
  },
  "usage": {
    "minutesProcessed": 1234,
    "minutesIncluded": 5000,
    "minutesOverage": 0,
    "jobsCompleted": 89,
    "jobsFailed": 2,
    "storageUsedBytes": 5368709120
  },
  "cost": {
    "basePlan": 4900,
    "overage": 0,
    "total": 4900,
    "currency": "usd"
  }
}

Code Examples

cURL

curl "https://api.audiospliter.com/api/v1/billing/usage?period=current" \
  -H "Authorization: Bearer your_jwt_token"

Node.js

const response = await fetch(
  'https://api.audiospliter.com/api/v1/billing/usage?period=current',
  { headers: { 'Authorization': `Bearer ${jwtToken}` } }
);
const { usage } = await response.json();
console.log(`Used ${usage.minutesProcessed} of ${usage.minutesIncluded} minutes`);

Python

import requests

response = requests.get(
    'https://api.audiospliter.com/api/v1/billing/usage',
    headers={'Authorization': f'Bearer {jwt_token}'},
    params={'period': 'current'},
)
usage = response.json()['usage']
print(f"Used {usage['minutesProcessed']} of {usage['minutesIncluded']} minutes")