GetLookupValues enables an application program to populate fields of a user interface with a list of values for a given column. This request is similar to the GetLookupValue request, but the response contains a list of lists rather than a single list.
This request can be used on any foreign key column. A foreign key to a lookup table has a limited set of values. Other foreign keys can have large numbers of possible values. This request is intended and most useful for lookup tables, when you want to display the list of acceptable values to a user.
The response contains a record for each column that has fields with the lookup information. In each field, the name is the lookup (foreign key) value and the value is the lookup display name.
Use Case
This is the common scenario for using the GetLookupValues request:
Fetch the valid values for a set of fields and display them in a UI
—In a custom UI, you can use getLookupValues to fetch a list of valid values for a set of fields. You can then display these values as a set of selections for the user.