Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Avatars

Get avatar usage

Get aggregate usage statistics for avatar conversations, including total duration, session counts, average duration, and a per-day breakdown. Per-day buckets are keyed by UTC calendar date. The date range must not exceed 90 days.

get/v1/avatar_usage

Query parameters

startDatestring date-time required

Start of the date range in UTC (inclusive). Required.

endDatestring date-time required

End of the date range in UTC (exclusive). Required.

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Response

Success

totalSecondsinteger required

Total seconds across conversations with a measured duration in the date range.

totalSessionsinteger required

Number of conversations started in the date range. Includes unfinished and failed conversations.

avgDurationSecondsinteger required

Average duration in seconds across conversations with a measured duration, or 0 if none completed. May not equal totalSeconds / totalSessions because unfinished conversations contribute to the session count but not the duration.