Skip to main content
List one quota’s target values per user and period, ordered by period (earliest first) then user id. Each row carries value, the owning user (an {id, email, name} reference), the period (at the quota’s frequency), and currency only when the quota is amount-typed. The quota’s type and frequency are surfaced once in the quota header. Pair with list_quotas to find the quota first. Filters combine with AND. You only see quotas and values you have access to; a quota you can’t access is reported as not found. Pass view_id to narrow to a single view’s rows. Each row exposes a resource_url pointing at its parent quota. The result also carries a list-level application_url that reopens the list you just fetched: the quota’s page with the chosen view selected. It is only set when a view_id was passed; otherwise it is null and the quota’s own resource_url already opens the page. The quota header lists the views whose ids you may pass back as view_id, but not who they are shared with: their access is null here. Ask get_quota when the question is who can read a view.

Parameters

Body

string
required
Id of the quota, from list_quotas, a sandbox’s quota included.
string
One period, in the quota’s frequency format: YYYY-MM (monthly), YYYY-QX (quarterly), YYYY-SX (semesterly) or YYYY (annually). Another frequency’s format is refused. Omit for every period.
Only these users’ values: every word must appear in the user’s name or email, in any order, case- and accent-insensitive. A 24-character hex string is read as an exact user id instead, and an unknown one is refused.
string
Id of one of the quota’s views (from list_quotas): only its users’ values. Omit for every user you can see.
integer
Rows per page, 1 to 250. Default 50.
integer
Rows to skip. Omit it for the first page, never null or the string ‘None’; for the next page pass the previous next_offset.

Response

Body

object
object[]
integer
string
Deep link to this list in the web app, with the view selected. Null when no view_id was passed (use the quota’s own resource_url).