How do I check my Code Buckets usage from the API?

curl https://api.codebuckets.clatterlabs.xyz/v1/usage \
  -H "Authorization: Bearer $CLATTER_API_KEY" -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"

You get:

• plan,
• period.month (UTC, like 2026-10),
• tokens: { used, included, unit },
• storage: { projects, buckets, stored_bytes, bucket_limit_bytes, backups_used, backups_included, public_files }, where public_files is this month's traffic to your public links.

Works with a key that has buckets:read or only account:read.

Learn more#

• Code Buckets API
• Errors