---
title: "List lists"
slug: "list-lists"
updated: 2026-06-26T09:19:50Z
published: 2026-06-26T09:19:50Z
canonical: "docs.xtremepush.com/list-lists"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List lists

Post/list/list

Used to get a list of lists. Review our [dedicated guide](https://docs.xtremepush.com/docs/create-a-user-list) for more information on user lists.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='e1dcbb84-dde5-49be-b750-e2be3347e03b'>application/json</option>
</select>object  apptokenstring    Required

Your App token

limitinteger  (int32)    

Used with *offset* for pagination

offsetinteger  (int32)    

Used with *limit* for pagination

Responses200

200

<select class='api-response-data' aria-label='Media type'><option value='855e2b8b-4862-45f8-83ce-66fb47ccfa68'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='bb8bb2d5-a95e-47aa-a99a-563942fbae11'>Result</option>
</select>Result

```json
{
  "success": "True",
  "code": "200",
  "data": [
    {
      "id": "3621063",
      "project_id": "PROJECT_ID",
      "name": "Restricted users",
      "identifier": "email",
      "suppress": "0"
    },
    {
      "id": "3621064",
      "project_id": "PROJECT_ID",
      "name": "Propensity for Product Y",
      "identifier": "user_id",
      "suppress": "0"
    },
    {
      "id": "3621214",
      "project_id": "PROJECT_ID",
      "name": "Propensity for Product z",
      "identifier": "profile_id",
      "suppress": "1"
    }
  ]
}
```

Expand Allobject  successboolean    DefaulttrueExampleTrue
codeinteger    Default0Example200
data Array of object   object  idinteger    Default0Example3621063
project_idstring    ExamplePROJECT_ID
namestring    ExampleRestricted users
identifierstring    Exampleemail
external_id
suppressinteger    Default0Example0

400

400

<select class='api-response-data' aria-label='Media type'><option value='befac072-3041-4b1e-9003-f1427eaffde0'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='45181b9a-efc5-4416-9eea-a5931502155f'>Result</option>
</select>Result

```json
{
  "success": "False",
  "code": "400",
  "message": "General error information",
  "errors": [
    {
      "text": [
        "Detailed information about the specific error"
      ]
    }
  ]
}
```

Expand Allobject  successboolean    DefaulttrueExampleFalse
codeinteger    Default0Example400
messagestring    ExampleGeneral error information
errors Array of object   object  text Array of string   string