---
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

## Changes

- **2025-03-12** `73745ce76c49` — 1 breaking, 3 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/ErrorResponse, subschema #1` from the response body `oneOf` list for the response status `200`
  - added the required property `lists` to the response with the `200` status
  - added the required property `next_cursor` to the response with the `200` status

[Change history](https://skmtc.dev/socialdata-api/apis/socialdata-api-reference/changes/twitter/user/:user_id/lists/get.md)

---

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