Usage and billing your customers

Daily usage per project and per organization (requests, egress, sizes, end users, monthly active users, function invocations) to bill your own customers.

MetricMeaning
requestsRequests to the project’s API host (REST, Auth, Storage, Realtime, Functions)
egress_bytes / ingress_bytesBytes sent / received by those requests
errors_5xxRequests answered with a server error
db_bytes / storage_bytesPeak database / file storage size that day
auth_users / mauEnd users / end users who signed in in the last 30 days (daily peak)
function_invocationsEdge Function invocations
Terminal
curl "https://stitchdb.com/platform/v1/projects/<ref>/usage?from=2026-10-01&to=2026-10-31" -H "Authorization: Bearer $STITCHDB_TOKEN"
curl "https://stitchdb.com/platform/v1/organizations/<org>/usage?from=2026-10-01&to=2026-10-31&format=csv" -H "Authorization: Bearer $STITCHDB_TOKEN" > usage.csv

The project report has current values, totals for the range (sums for traffic, peaks for sizes and users) and one row per day. The organization report lists every project with its labels (deleted projects stay in the history), so you can group by your customer_id. Traffic is counted every 5 minutes; days are UTC; history is kept 400 days. Needs the usage:read scope.