​
Storage Limits

Each SparkDB plan comes with a storage quota for your buckets. Monitor usage and upgrade to store more.

​
Plan Comparison

PlanPriceBucket StorageMax DatabasesBadge
Free$01 GB3—
Plus$19/mo10 GB10Blue
Pro$79/mo20 GB10Green
Max$299/mo50 GBUnlimitedGold
During the preview period, all tiers are effectively free. The storage limit defaults to the Free tier’s 1 GB. Full billing is coming soon.

​
Storage Calculation

Your storage usage is the sum of all file sizes across all active (non-deleted) buckets. This is calculated after every upload and delete operation: 
Total Storage = SUM(storage_bytes) for all active buckets

​
Example

Bucket A: 350 MB  (marketing images)
Bucket B: 120 MB  (user uploads)
Bucket C: 50 MB   (backups)
─────────────────────────────
Total:    520 MB / 1 GB (50.8% of Free tier)

​
Checking Usage

​
Via Dashboard

The buckets page shows a storage usage bar at the top: 
[████████████░░░░░░░░░] 520 MB / 1 GB (50.8%)

​
Via API

curl
curl https://api.sparkdb.pro/api/billing/status \
  -H "Cookie: session=..."  # Authenticated session
Response
{
  "plan": "free",
  "usage": {
    "bucket_bytes": 545259520
  },
  "limits": {
    "bucket_storage_bytes": 1073741824
  }
}

​
Storage Bytes by Plan

PlanRaw Bytes
Free1,073,741,824
Plus10,737,418,240
Pro21,474,836,480
Max53,687,091,200

​
What Happens When You Hit the Limit?

When an upload would exceed your plan’s storage limit, the API returns a 409 Conflict error: 
{
  "error": "Storage limit exceeded. 1 GB",
  "message": "Storage limit exceeded: 1 GB. Upgrade to increase your limit."
}
Existing files remain accessible — only new uploads are blocked. Delete files or upgrade your plan to continue uploading.

​
Freeing Up Storage

  1. Delete individual files — click the trash icon next to any file in the dashboard
  2. Delete entire buckets — deletes all files in the bucket and frees up storage
  3. Upgrade your plan — get more storage with Plus, Pro, or Max

​
Object Count

There is no limit on the number of objects per bucket or account. You can store millions of small files as long as total storage stays within your plan limit.