Usage

Returns usage statistics for the current billing period, including total calls, breakdown by pipeline tier and content context, and your rate limit.

Request

This endpoint takes no request body or query parameters. Authenticate with your API key.

curl https://api.getsieve.dev/v1/usage \
  -H "Authorization: Bearer mod_live_abc123..."

const response = await fetch("https://api.getsieve.dev/v1/usage", {
  headers: {
    "Authorization": "Bearer mod_live_abc123...",
  },
});

const usage = await response.json();

import requests

response = requests.get(
    "https://api.getsieve.dev/v1/usage",
    headers={"Authorization": "Bearer mod_live_abc123..."},
)

usage = response.json()

Response

The current billing period.

ISO 8601 start date of the billing period.

ISO 8601 end date of the billing period.

Your current plan: free, indie, or pro.

Total moderation API calls made this period.

Maximum calls allowed for your plan this period.

Breakdown of calls by pipeline tier.

Calls handled by local Rust/WASM processing.

Calls handled by OpenAI omni-moderation.

Calls handled by Claude Haiku.

Breakdown of calls by content context.

Calls with default context.

Calls with username context.

Calls with chat context.

Calls with forum_post context.

Calls with comment context.

Your current rate limit configuration.

Maximum requests per second for your plan.

Example Response

{
  "period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-31T23:59:59Z"
  },
  "plan": "indie",
  "total_calls": 42150,
  "calls_limit": 100000,
  "calls_by_tier": {
    "tier_0": 28302,
    "tier_1": 11540,
    "tier_2": 2308
  },
  "calls_by_context": {
    "default": 15200,
    "username": 3400,
    "chat": 18550,
    "forum_post": 3800,
    "comment": 1200
  },
  "rate_limit": {
    "requests_per_second": 50
  }
}