Relay

Usage

Read aggregated usage for your project — participant, video, and audio minutes — totalled over a period and broken down by day.

GEThttps://api.relay.welbuiltai.tech/v1/usage

Authentication

Send your secret key as a Bearer token, the same as every other endpoint:

HTTP header
Authorization: Bearer sk_live_...

Query parameters

ParameterDescription
period
optional
One of today, 7d, 30d, or all. Defaults to 30d.

Response

Returns the requested period, rolled-up totals, and a daily array of per-day rollups. Each daily entry includes date, participantMinutes, videoMinutes, audioMinutes, and peakParticipants.

Example

curl
curl "https://api.relay.welbuiltai.tech/v1/usage?period=30d" \
  -H "Authorization: Bearer sk_live_..."

Example response:

200 OK
{
  "period": "30d",
  "totals": {
    "participantMinutes": 1842.5,
    "videoMinutes": 1203.0,
    "audioMinutes": 639.5
  },
  "daily": [
    {
      "date": "2026-06-18T00:00:00.000Z",
      "participantMinutes": 96.0,
      "videoMinutes": 60.0,
      "audioMinutes": 36.0,
      "peakParticipants": 4
    }
  ]
}