---
title: "Get User's Lists"
method: GET
path: "/twitter/user/{user_id}/lists"
tags: ["Data API"]
---

# Get User's Lists

`GET /twitter/user/{user_id}/lists`

Returns array of lists a user created or is subscribed to. Typically Twitter returns up to 100 lists per page. You can request additional results by sending another request to the same endpoint using cursor parameter.

## Path parameters

- `user_id` string, required

## Query parameters

- `cursor` string

## Response `200`

Request succeeded

- object
  - `next_cursor` string, required — Cursor for pagination to get the next page of results
  - `lists` object[], required

## Other responses

- `402` — Payment required - not enough credits to perform this request. You should purchase additional credits
- `422` — Validation failed (e.g. user_id is not provided or in invalid format)
- `500` — API internal error, typically means that SocialData API failed to obtain the requested information. Retry may succeed

---

[API](https://skmtc.net/socialdata-api/apis/socialdata-api-reference.md) · [All operations](https://skmtc.net/socialdata-api/apis/socialdata-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialdata-api/socialdata-api-reference/versions/a898522f71ac/schema)