Relay

Platform

Usage & Billing

Query real-time usage data for the current billing period — participant minutes, active halls, and moderation clips. Overage is automatically billed to your Stripe invoice at the end of each cycle.

Get current usage

GET/v1/usage

Returns current billing period usage for your organisation.

curl
1
2
curl https://api.relay.dev/v1/usage \
  -H "Authorization: Bearer relay_live_..."
Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "period_start": "2025-04-01T00:00:00Z",
  "period_end": "2025-04-30T23:59:59Z",
  "plan_tier": "growth",
  "participant_minutes_used": 8432,
  "participant_minutes_included": 30000,
  "overage_minutes": 0,
  "overage_cost_usd": 0.00,
  "overage_rate_per_minute": 0.002,
  "moderation_clips_analyzed": 12,
  "active_halls": 2,
  "max_concurrent_halls": 50,
  "recording_enabled": true,
  "moderation_enabled": true
}

Plan limits in the response

The usage response always includes your plan's limits so your application can enforce capacity checks without hardcoding values:

participant_minutes_included

Minutes included in your plan this period. Usage above this is charged as overage.

max_concurrent_halls

Maximum simultaneous active halls. null = unlimited.

recording_enabled

Whether recording is available on your plan.

moderation_enabled

Whether AI moderation is available on your plan.

overage_rate_per_minute

USD per overage minute. Added to your next invoice.

Overage billing

At the end of each billing cycle, Relay calculates your overage and adds it as a line item to your Stripe invoice:

Starter

10,000 / mo included

$0.002/min overage

Growth

30,000 / mo included

$0.002/min overage

Monitor your participant_minutes_used in real time and alert your team when you exceed 80% of your included minutes to avoid unexpected charges.

Moderation billing

AI moderation (Google Cloud Video Intelligence) is billed at cost + 20% margin. The total is added to your monthly Stripe invoice as a separate line item with a per-clip breakdown. Cost varies by clip duration — see Google's pricing page for base rates.