Media Caption API v1

Balance

Read the current credit balance for the authenticated account.

Endpoint

GET/v1/balance

Example

curl https://api.mediacaption.io/v1/balance \
  -H "Authorization: Bearer mc_live_xxx"

Response

{
  "balance": {
    "credits": 20,
    "subscriptionCredits": 12,
    "bundleCredits": 8,
    "monthlyCreditLimit": 100,
    "monthlyCreditsRenewAt": "2026-06-11T10:00:00.000Z"
  }
}

Balance fields

  • credits: total spendable balance across subscription and bundle credit pools.
  • subscriptionCredits: credits from the active subscription grant.
  • bundleCredits: purchased or granted credits that do not expire through subscription renewal.
  • monthlyCreditLimit and monthlyCreditsRenewAt: populated for active subscriptions when renewal details are available.
Next: Single Transcript