RillaRilladevelopers
Go to Rilla
DocumentationData Export APIFull reference

List conversations

List the conversations in a date range, newest first, with search and filters.

GET/export/conversations
Authentication
Authorization: YOUR_API_KEY

No Bearer prefix.

Base URL: https://customer.rillavoice.com

Parameters

fromDatestring · date-time · queryrequired

Start of the period, as a UTC timestamp ending in Z, such as 2026-09-01T00:00:00Z. Included.

toDatestring · date-time · queryrequired

End of the period, as a UTC timestamp ending in Z, on or after fromDate. Included.

dateTypeenum · query

timeOfRecording (default) selects and sorts by when the conversation was recorded; processedDate, by when it finished processing.

userIdsstring[] · uuid · query

Only these users’ conversations, up to 100, by userId from List users. Comma-separated or repeated. Send this or teamId, not both.

teamIdstring · uuid · query

Only this team’s users’ conversations, by teamId from List teams. Send this or userIds, not both.

includeSubteamsboolean · query

With teamId, also include the users of the team’s subteams. true without teamId is rejected.

querystring · query

Part of the title or job number, case-insensitive, up to 200 characters. Titles usually hold the customer name.

outcomestring · query

Only conversations with this outcome as the rows show it, case-insensitive, up to 100 characters: sold matches Sold but not Not Sold.

minDurationinteger · query

Only conversations at least this many seconds long, up to 86400.

orderenum · query

desc (default) for newest first, asc for oldest first.

pageinteger · query

Page to return, from 1, up to 10,000. Defaults to 1.

limitinteger · query

Conversations per page, up to 100. Defaults to 100.

Always paged. Rows are light: fetch one conversation in full with Get a conversation. Removed users’ conversations are included.

Responses

200Returns ConversationListResponse
conversationsConversationListEntry[]

Conversations on this page, newest first unless order is asc.

currentPagenumber

The page returned.

totalPagesnumber

Pages available; request the next page to get more.

totalConversationsnumber

Conversations across all pages.

401Missing or invalid API key.
403With teamId, your key is limited to teams that no longer exist.
400Invalid request parameters.
Error reference

Common problems

400 · "Request body failed validation"

The message is the same for invalid query and path parameters. Read errors[].path and errors[].message. Send every parameter in the query string, URL-encoded; these GET requests take no body. fromDate and toDate are required UTC timestamps ending in Z, and fromDate must be on or before toDate. limit is at most 100. Send userIds or teamId, not both, and includeSubteams only with teamId.

401 · Missing or invalid key

Use Authorization: YOUR_API_KEY, without Bearer, and the customer.rillavoice.com host. Use the key value, not its ID.

403 · "Caller has no accessible export scope"

With teamId, your key is limited to teams that no longer exist. Create a key with current teams, or one with organization-wide access.

200 · Empty or missing rows

Results are limited to what your API key can access; an unknown teamId or userIds or one outside that scope gives an empty page. Keep requesting the next page until currentPage reaches totalPages.

← Export conversationsGet a conversation