Usage & billing¶

How a call is billed¶

Tele bills room-minutes: the time a call's room is in use. Participant count doesn't multiply the price.

1. Tele records every participant's join and leave time.
2. Billable time is the time during which at least min_participants people (default 1) were connected. Gaps when nobody is in the room aren't billed.
3. Billable time is rounded up to the next whole minute (ceil_minute, the default) or kept per second (per_second).
4. The result is multiplied by the rate's price per minute. The default is 1 BDT.

Charges are recorded when a room session closes, usually about 30 seconds after the last person leaves. They're attributed to your consumer, the host's team at the time the call was created, and the host.

Call records¶

GET /v1/calls/{id}/sessions (host or service token) returns the full record:

{
  "sessions": [{
    "id": "01a131e4-…",
    "status": "billed",
    "started_at": "2026-10-13T09:00:00Z",
    "ended_at": "2026-10-13T09:10:05Z",
    "duration_seconds": 605,
    "billable_seconds": 605,
    "billable_minutes": "11.0000",
    "amount": "11.0000",
    "currency": "BDT",
    "peak_participants": 2,
    "unique_participants": 2,
    "participants": [
      { "user_id": "alice", "name": "Alice", "joined_at": "2026-10-13T09:00:00Z", "left_at": "2026-10-13T09:10:05Z",
        "duration_seconds": 605, "ip": "198.51.100.1", "user_agent": "Mozilla/5.0 …", "platform": "web",
        "disconnect_reason": "CLIENT_INITIATED" },
      { "user_id": "bob", "name": "Bob", "joined_at": "2026-10-13T09:01:00Z", "left_at": "2026-10-13T09:05:00Z",
        "duration_seconds": 240, "ip": "198.51.100.2", "platform": "flutter" }
    ]
  }]
}

• status is open while the call is running, then closed, then billed.
• ip and user_agent become null after 30 days.
• Monetary values are decimal strings with 4 decimal places, so no precision is lost to floating point.

Usage reports¶

GET /v1/usage with a service token returns totals for your consumer:

curl "$TELE_API/v1/usage?from=2026-10-01&to=2026-11-01&group_by=team" -H "Authorization: Bearer $SERVICE_TOKEN"

{
  "from": "2026-10-01T00:00:00Z", "to": "2026-11-01T00:00:00Z", "group_by": "team",
  "rows": [
    { "group": { "api_key": "TK3f9…", "team": "sales" }, "sessions": 42, "room_seconds": 51310,
      "room_minutes": "877.0000", "recording_minutes": "0.0000", "adjustments": "0.0000",
      "amount": "877.0000", "currency": "BDT" }
  ]
}

Usage is filtered by when each session started. Monthly grouping (group_by=month) follows the Asia/Dhaka calendar.

Rates¶

The Tele team manages rates. A rate can apply:

• organisation-wide (the default: 1 BDT/min, ceil),
• to one consumer,
• to one team within a consumer.

The most specific rate in effect when a call started is the one that applies. Rate changes are never applied retroactively; past charges keep the rate they were billed with.

To request a team or consumer-specific rate, contact the Tele team.