# Get all lists

You can return a list with all of your users’ lists. Use a returned URL to list all users added to the list.

GET /lists/

# Request

  • CURL
  • JavaScript
  • PHP
  • Python
curl -X GET -H "Authorization: Token <your_64_char_api_key>"
-H "Accept: */*; version=2"
"https://<your_app_subdomain>.user.com/api/public/lists/"

# Response

{
  "next": "null",
  "count": 3,
  "previous": null,
  "results": [
    {
      "id": 7,
      "name": "New List",
      "description": "This is description for this list",
      "users": "https://eu.user.com/api/public/lists/7/users/"
    },
    {
      "id": 8,
      "name": "Another List",
      "description": "Another description",
      "users": "https://eu.user.com/api/public/lists/8/users/"
    },
    {
      "id": 140,
      "name": "List without description",
      "description": "",
      "users": "https://eu.user.com/api/public/lists/140/users/"
    }
  ]
}