Go to Rilla

List teams

List teams without metrics, to find a teamId.

GET/export/teams
Authentication
Authorization: YOUR_API_KEY

No Bearer prefix.

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

Parameters

querystring · query

Part of a team name, case-insensitive, up to 200 characters.

parentTeamIdstring · uuid · query

Only this team’s direct subteams.

pageinteger · query

Page to return, from 1. Needs limit; without it, every team your key can access comes back on one page.

limitinteger · query

Teams per page, up to 10,000. Omit it to get every team your key can access at once.

Sorted by name. Results remain restricted to the teams your API key can access.

Responses

200Returns TeamListResponse
teamsTeamListEntry[]

Teams on this page, sorted by name.

currentPagenumber

The page returned.

totalPagesnumber

Pages available; request the next page to get more.

totalTeamsnumber

Teams across all pages.

401Missing or invalid API key.
403Your 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. page needs limit; each is a positive integer up to 10,000.

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"

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 parentTeamId or one outside that scope gives an empty page. Keep requesting the next page until currentPage reaches totalPages.