Used to get a list of all the lists associated with your project. All lists can be returned if no condition is used. Only lists of a certain type will be returned if a condition with specific criteria is provided.

Review our dedicated guide for more information on user lists.


Get a list of the user lists that use email as the primary identifier using pagination. For best results, we recommend setting a limit on your query. Send several requests to obtain the full list:

curl --request POST \
  --url \
  --header 'content-type: application/json' \
  --data '{
    "apptoken": "YOUR_APPTOKEN",
    "condition": [
      ["identifier", "=" , "email"]
    "limit": 50,
    "offset": 0
Click Try It! to start a request and see the response here!