Back to Support
Billing & Quotas

How to Check Your Usage and Quota

Where to see your usage limits and what happens when you hit quota

How to Check Your Usage and Quota


Every FFmpeg Micro account has monthly quotas based on your plan. Here's how to track your usage and understand what happens at the limit.


Checking Your Current Usage


Dashboard


The easiest way to check usage is via the dashboard:


  • Go to /dashboard/usage
  • View your current month's:
  • - Transcodes completed (out of monthly quota)

    - Processing time (total minutes)

    - Storage used (GB)

    - Bandwidth used (GB)


    API Endpoint


    You can also check usage programmatically:


    curl -X GET "https://api.ffmpeg-micro.com/v1/account/usage" \
      -H "Authorization: Bearer YOUR_API_KEY"
    

    Response:

    {
      "period": "2025-01",
      "quota": {
        "transcodes": 1000,
        "processingMinutes": 500,
        "storage": 100,
        "bandwidth": 1000
      },
      "usage": {
        "transcodes": 450,
        "processingMinutes": 234,
        "storage": 45,
        "bandwidth": 567
      },
      "remaining": {
        "transcodes": 550,
        "processingMinutes": 266,
        "storage": 55,
        "bandwidth": 433
      }
    }
    

    Understanding Your Plan Limits


    Free Tier

  • 100 transcodes/month
  • 50 processing minutes
  • 10 GB storage
  • 100 GB bandwidth

  • Starter ($29/month)

  • 1,000 transcodes/month
  • 500 processing minutes
  • 100 GB storage
  • 1 TB bandwidth

  • Professional ($99/month)

  • 5,000 transcodes/month
  • 2,500 processing minutes
  • 500 GB storage
  • 5 TB bandwidth

  • Enterprise (Custom)

  • Custom limits
  • Dedicated support
  • SLA guarantees

  • View current pricing at /pricing


    What Happens When You Hit Quota


    Soft Limit (90% of quota)


    When you reach 90% of your monthly quota:

  • You'll receive an email warning
  • A banner appears in your dashboard
  • Your usage page shows a warning

  • Action: Consider upgrading your plan or monitoring usage more closely.


    Hard Limit (100% of quota)


    When you hit 100% of your quota:

  • New transcode requests return 402 Payment Required
  • Existing jobs continue to process
  • Downloads still work for completed jobs
  • Dashboard remains accessible

  • Response Example:

    {
      "error": "Monthly quota exceeded",
      "message": "You've used all 1000 transcodes for this month. Upgrade your plan or wait until 2025-02-01.",
      "quotaReset": "2025-02-01T00:00:00Z",
      "currentUsage": 1000,
      "quotaLimit": 1000
    }
    

    Solutions When You Hit Quota


  • Wait for reset — quotas reset on the 1st of each month
  • Upgrade your plan — visit /dashboard/billing
  • Purchase add-on quota — contact support for one-time quota increases
  • Optimize your usage — review your transcode settings for efficiency

  • Quota Reset Schedule


    Quotas reset at 00:00 UTC on the 1st of each month, regardless of when you signed up.


    Example:

  • Sign up: January 15
  • First quota reset: February 1
  • All subsequent resets: 1st of the month

  • Monitoring Usage Proactively


    Set Up Alerts


    Contact support to configure custom usage alerts:

  • Email when you hit 50%, 75%, 90% of quota
  • Slack/webhook notifications
  • Daily usage reports

  • Usage Webhooks


    Set up a webhook to receive real-time usage updates:


    curl -X POST "https://api.ffmpeg-micro.com/v1/account/webhooks" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "url": "https://your-app.com/webhooks/ffmpeg-usage",
        "events": ["usage.warning", "usage.limit"]
      }'
    

    Build Your Own Monitoring


    Poll the usage endpoint periodically:


    async function checkUsage() {
      const response = await fetch('https://api.ffmpeg-micro.com/v1/account/usage', {
        headers: {
          'Authorization': 'Bearer YOUR_API_KEY'
        }
      })
    
      const { usage, quota } = await response.json()
    
      const percentUsed = (usage.transcodes / quota.transcodes) * 100
    
      if (percentUsed > 90) {
        alert('⚠️ You\'ve used ' + percentUsed + '% of your monthly quota!')
      }
    }
    
    // Check every hour
    setInterval(checkUsage, 60 * 60 * 1000)
    

    Optimizing Your Usage


    Tips to Reduce Transcode Count


  • Batch processing — combine multiple small jobs into one
  • Optimize quality — don't use "high" quality if "medium" works
  • Cache results — store transcoded videos to avoid re-processing
  • Use presets wisely — custom FFmpeg options can be less efficient

  • Tips to Reduce Processing Time


  • Lower resolution — 720p uses ~50% less time than 1080p
  • Simpler effects — text overlays are faster than complex filters
  • Shorter videos — consider splitting long videos if possible

  • FAQs


    Q: Can I roll over unused quota to next month?

    A: No, quotas reset each month and don't carry over.


    Q: Can I purchase additional quota without upgrading?

    A: Yes, contact support for one-time quota add-ons.


    Q: Do failed jobs count toward my quota?

    A: No, only successfully completed transcodes count.


    Q: What timezone is the quota reset?

    A: UTC (00:00 UTC on the 1st of each month).


    Need More Quota?


  • Upgrade your plan: /dashboard/billing
  • Contact sales: javid@ffmpeg-micro.com for custom Enterprise plans
  • Purchase add-on: One-time quota increases available

  • Still Have Questions?


    Contact support at javid@ffmpeg-micro.com with:

  • Your current plan
  • Expected monthly usage
  • Any special requirements