Stats

GET /api/v1/stats

Returns usage statistics for your account over a date range, plus your current plan limits.

Query parameters

Parameter	Type	Default	Description
`days`	integer	`30`	Number of past days to include

Example

curl "https://medianest.app/api/v1/stats?days=7" \
  -H "X-API-Key: mn_your_key"

Response

{
  "success": true,
  "data": {
    "summary": {
      "totalFiles": 142,
      "recentUploads": 12,
      "storageBytes": 1073741824,
      "bandwidthBytes": 536870912,
      "apiCallsTotal": 340,
      "aiCreditsUsed": 45
    },
    "limits": {
      "plan": "PRO",
      "storageBytes": 107374182400,
      "bandwidthBytes": 536870912000,
      "maxFileSize": 104857600,
      "apiCallsPerDay": 10000,
      "aiCreditsPerMonth": 500
    },
    "usage": {
      "storagePercent": 1,
      "bandwidthPercent": 0,
      "storageRemaining": 106300440576,
      "bandwidthRemaining": 536334041088
    },
    "daily": [
      { "date": "2026-05-05", "storageBytes": 0, "bandwidthBytes": 12345, "apiCallsTotal": 48 }
    ]
  }
}