List value lists
List the value lists of your account, each with its choices, so a field offering choices can name the one it takes them from.
A value list is a named set of choices defined once for the account and reused by any number of fields: genders, phone labels, contact categories. The lists are in the order the settings show them, and the choices of each in their own order.
Only the shared lists are here. The choices somebody typed into a single field belong to that field and are not listed.
This endpoint also answers QUERY, with the same parameters sent in the request body. How QUERY works.
Query parameters
Sent as JSON. Anything not listed here is ignored.
Which page to answer with.
How many one page holds, between 1 and 100. A number outside the range is brought back into it rather than refused.
Returns
A page of value lists, and how many there are in all. The lists of another account are never included.
The value lists on this page. An empty list rather than an error when there are none.
One value list.
Always value_list.
The id of the list, which is what value_list_id takes when a field is added or configured.
What the list holds.
What the list is called.
The choices the list offers, in their order. An empty list when it offers none yet.
One choice.
The id of the choice, which is what a field offering this list stores as its value.
What the choice says.
Where you are in the collection.
The page this is, counting from 1.
How many one page holds, which is the size that was asked for once it has been brought into the allowed range.
How many value lists there are in all, not how many are on this page.
Rate limit
Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.
Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.