Get usage statistics

Get current usage statistics for your subscription including credits, transcription minutes, storage, and API request metrics.

GET /usage

cURL

cURL

curl -X GET https://app.mavera.io/api/v1/usage \
  -H "Authorization: Bearer mvra_live_your_key_here"

200

{
  "object": "usage",
  "billing_period": {
    "start": "2024-03-01T00:00:00.000Z",
    "end": "2024-03-31T23:59:59.999Z"
  },
  "credits": {
    "used": 2500,
    "included": 5000,
    "remaining": 2500,
    "percentage_used": 50
  },
  "transcription": {
    "minutes_used": 45.5,
    "minutes_included": 500,
    "minutes_remaining": 454.5,
    "percentage_used": 9
  },
  "storage": {
    "gb_used": 2.5,
    "gb_included": 50,
    "gb_remaining": 47.5,
    "percentage_used": 5
  },
  "api_requests": {
    "total_requests": 1250,
    "total_tokens": 125000,
    "prompt_tokens": 75000,
    "completion_tokens": 50000,
    "credits_used": 2500,
    "error_count": 12,
    "avg_latency_ms": 850
  },
  "rate_limit": {
    "requests_per_minute": 120
  },
  "auto_recharge": {
    "enabled": true,
    "threshold": 100,
    "credits_to_add": 1000
  },
  "limits": {
    "budget_alert": 4000,
    "usage_limit": null
  }
}

Authorizations

Authorization · string · header · required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Response

200

application/json

Usage statistics

Current usage statistics for your subscription

object · enum<string>

Available options: usage

billing_period · object

Current billing period dates

Show child attributes

credits · object

Credit usage for the current billing period

Show child attributes

transcription · object

Transcription minutes usage

Show child attributes

storage · object

Storage usage

Show child attributes

api_requests · object

API request statistics for the current billing period

Show child attributes

rate_limit · object

Rate limit configuration for your API key

Show child attributes

auto_recharge · object

Auto-recharge configuration

Show child attributes

limits · object

Budget and usage limits

Show child attributes