Export users
Export rep activity, recording compliance, coaching, and engagement metrics.
/export/usersAuthorization: YOUR_API_KEYNo Bearer prefix.
Base URL: https://customer.rillavoice.com
Body parameters
fromDatestring · date-timerequiredStart of the export window. Use an ISO 8601 timestamp in UTC, such as 2026-09-01T00:00:00Z.
toDatestring · date-timerequiredEnd of the export window. Use a UTC timestamp ending in Z and a value after fromDate. See Date windows for metric-specific boundary behavior.
usersstring[]Exact, case-sensitive Rilla user emails (not IDs). Omit or send [] for all users. With a team-scoped key, a filter matching none of the allowed users currently falls back to all allowed users.
This endpoint is not paginated. Some analytics can be null; keep “not available” distinct from a measured zero.
Responses
200Returns UsersExportResponse401Missing or invalid API key.400Invalid request parameters.Date windows
Send UTC timestamps ending in Z; date-only values and timezone offsets are not accepted. Choose fromDate < toDate; the API does not enforce date ordering.
Conversation exports include both boundaries. Most user/team metrics do too, but scorecards and live coaching exclude the end boundary. Profile fields and current team membership are not historical snapshots.
For incremental conversation exports, overlap windows and deduplicate by conversationId or recordingId. Download audio/transcripts promptly; signed URLs expire after 6 hours and may expire sooner with the signing credentials.
Common problems
400 · "Invalid JSON in request body"
Use straight double quotes ("), not smart quotes (“ ”), and remove trailing commas. Validate the body locally with python3 -m json.tool request.json. A JSON syntax error occurs before date or email validation.
400 · "Validation failed"
Read errors[].path and errors[].message. fromDate/toDate must be UTC timestamps ending in Z; users must be an array of valid email strings.
401 · Missing or invalid key
Use Authorization: YOUR_API_KEY, without Bearer. Use the key value, not its ID, and the customer.rillavoice.com host.
200 · Empty or unexpected results
Replace sample email addresses with a real Rilla email; matching is exact and case-sensitive. Omit users (or send []) to request all users. With a team-scoped key, a non-empty filter with no allowed matches currently falls back to all allowed users. Verify returned emails; do not rely on the filter as an access-control boundary.
A metric is null, zero, or differs from a dashboard
Null means no applicable measurement; zero is a numeric result. Users and teams include more than successful conversations: conversationsRecorded counts recordings. See the linked type for units, date basis and aggregation rules.