# X Lists API

**Canonical:** https://apis.io/apis/x/x-lists-api/  
**Provider:** X — https://apis.io/providers/x/  
**Base URL:** https://api.x.com  
**Documentation:** https://docs.x.com/x-api/lists/introduction

X Lists API is one of 23 APIs that [X](https://apis.io/providers/x/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include List. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Endpoints related to retrieving, managing Lists — 9 operation(s) in the X-published contract.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/2/lists` | Create Lists |
| DELETE | `/2/lists/{id}` | Delete List |
| GET | `/2/lists/{id}` | Get Lists by ID |
| PUT | `/2/lists/{id}` | Update List |
| GET | `/2/lists/{id}/followers` | Get Lists Followers |
| GET | `/2/lists/{id}/members` | Get Lists Members |
| POST | `/2/lists/{id}/members` | Add Lists Member |
| DELETE | `/2/lists/{id}/members/{user_id}` | Remove a List member |
| GET | `/2/lists/{id}/tweets` | Get Lists Posts |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-lists-api-openapi.yml
- **Documentation** — https://docs.x.com/x-api/lists/introduction

## Other X APIs (12)

- [X Account Activity API](https://apis.io/apis/x/x-account-activity-api/)
- [X Account API](https://apis.io/apis/x/x-account-api/)
- [X Activity API](https://apis.io/apis/x/x-activity-api/)
- [X Articles API](https://apis.io/apis/x/x-articles-api/)
- [X Bots API](https://apis.io/apis/x/x-bots-api/)
- [X Broadcasts API](https://apis.io/apis/x/x-broadcasts-api/)
- [X Chat API](https://apis.io/apis/x/x-chat-api/)
- [X Communities API](https://apis.io/apis/x/x-communities-api/)
- [X Community Notes API](https://apis.io/apis/x/x-community-notes-api/)
- [X Compliance API](https://apis.io/apis/x/x-compliance-api/)
- [X Connections API](https://apis.io/apis/x/x-connections-api/)
- [X Direct Messages API](https://apis.io/apis/x/x-direct-messages-api/)

## Tags

List

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/x/x-lists-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/x/.