Get Statistics

Get comprehensive dashboard statistics

GET /api/v1/stats

cURL

curl "https://api.fileguard.io/api/v1/stats" \
  -H "Authorization: Bearer fg_your_api_key"

200 OK

{
  "status": "SUCCESS",
  "data": {
    "overview": {
      "total_files": 847000,
      "total_contexts": 5,
      "total_api_keys": 12,
      "total_downloads": 125000
    },
    "api_calls": {
      "today": 12847,
      "yesterday": 10887,
      "change_percent": 18.0,
      "by_operation": {
        "upload": 5200,
        "download": 6847,
        "metadata": 700,
        "delete": 100
      },
      "by_status": {
        "success": 12500,
        "failure": 347
      }
    },
    "storage": {
      "total_bytes": 2638827520000,
      "total_formatted": "2.4 TB",
      "by_context": [
        {
          "context_key": "patient_reports",
          "context_name": "Patient Reports",
          "count": 450000,
          "total_bytes": 1500000000000
        },
        {
          "context_key": "lab_results",
          "context_name": "Lab Results",
          "count": 250000,
          "total_bytes": 800000000000
        },
        {
          "context_key": "imaging_scans",
          "context_name": "Imaging Scans",
          "count": 147000,
          "total_bytes": 338827520000
        }
      ]
    },
    "storage_quota": {
      "quota_mb": 5120000,
      "used_bytes": 2638827520000,
      "used_formatted": "2.4 TB",
      "used_percent": 50.37,
      "remaining_bytes": 2731172480000,
      "remaining_formatted": "2.5 TB"
    },
    "files_uploaded": {
      "total": 847000,
      "today": 5200,
      "yesterday": 4800,
      "change_percent": 8.33
    },
    "security": {
      "files_blocked_total": 1250,
      "blocked_today": 15,
      "blocked_yesterday": 12,
      "change_percent": 25.0,
      "by_reason": {
        "blank_file": 450,
        "corrupt_file": 320,
        "virus_detected": 25,
        "invalid_extension": 400,
        "size_exceeded": 55
      }
    }
  },
  "timestamp": "2026-01-17T10:00:00Z"
}

Get comprehensive statistics and insights for your tenant including files, API calls, storage, and security metrics.

cURL

curl "https://api.fileguard.io/api/v1/stats" \
  -H "Authorization: Bearer fg_your_api_key"

200 OK

{
  "status": "SUCCESS",
  "data": {
    "overview": {
      "total_files": 847000,
      "total_contexts": 5,
      "total_api_keys": 12,
      "total_downloads": 125000
    },
    "api_calls": {
      "today": 12847,
      "yesterday": 10887,
      "change_percent": 18.0,
      "by_operation": {
        "upload": 5200,
        "download": 6847,
        "metadata": 700,
        "delete": 100
      },
      "by_status": {
        "success": 12500,
        "failure": 347
      }
    },
    "storage": {
      "total_bytes": 2638827520000,
      "total_formatted": "2.4 TB",
      "by_context": [
        {
          "context_key": "patient_reports",
          "context_name": "Patient Reports",
          "count": 450000,
          "total_bytes": 1500000000000
        },
        {
          "context_key": "lab_results",
          "context_name": "Lab Results",
          "count": 250000,
          "total_bytes": 800000000000
        },
        {
          "context_key": "imaging_scans",
          "context_name": "Imaging Scans",
          "count": 147000,
          "total_bytes": 338827520000
        }
      ]
    },
    "storage_quota": {
      "quota_mb": 5120000,
      "used_bytes": 2638827520000,
      "used_formatted": "2.4 TB",
      "used_percent": 50.37,
      "remaining_bytes": 2731172480000,
      "remaining_formatted": "2.5 TB"
    },
    "files_uploaded": {
      "total": 847000,
      "today": 5200,
      "yesterday": 4800,
      "change_percent": 8.33
    },
    "security": {
      "files_blocked_total": 1250,
      "blocked_today": 15,
      "blocked_yesterday": 12,
      "change_percent": 25.0,
      "by_reason": {
        "blank_file": 450,
        "corrupt_file": 320,
        "virus_detected": 25,
        "invalid_extension": 400,
        "size_exceeded": 55
      }
    }
  },
  "timestamp": "2026-01-17T10:00:00Z"
}

Response Sections

Overview

High-level metrics across your tenant.

Field	Description
total_files	Total files stored
total_contexts	Number of file contexts
total_api_keys	Number of API keys
total_downloads	Total download count

API Calls

API usage with daily comparison.

Field	Description
today	Calls today (UTC)
yesterday	Calls yesterday
change_percent	Day-over-day change
by_operation	Breakdown by operation type
by_status	Success vs failure counts

Storage

Storage usage breakdown.

Field	Description
total_bytes	Total storage in bytes
total_formatted	Human-readable size
by_context	Top 3 contexts by storage

Security

Files blocked by validation.

Field	Description
files_blocked_total	Total files blocked
by_reason	Breakdown by rejection reason

Requires metadata scope on your API key.