Get a public X List

GET /v1/x/lists/{id}

Returns a List's name, description, owner, and member and follower counts. Read its members with getXListMembers and its timeline with getXListPosts. 404 when the List does not exist or is private. Billed per List returned.

Price: 1 credit per call, plus 2 credits per X list returned. Failed and refused calls cost nothing.

Rate limit: Counts as 1 request against your per-minute rate limit.

MCP tool: get_x_list, on every MCP connection.

Requires an API key, sent as Authorization: Bearer <key>.

Request

curl --request GET \
  --url https://api.weirapp.io/v1/x/lists/ID \
  --header "Authorization: Bearer $WEIR_API_KEY"

Path parameters

Field	Type	Required	Notes
`id`	string	yes	Numeric List id: the digits after `/i/lists/` in a List's URL. · matches `^\d{1,19}$`

Response

One X List.

`200`

Field	Type	Required	Notes
`data`	object	yes
`data.id`	string	yes
`data.name`	string	yes
`data.description`	string or null	yes
`data.url`	string	yes	`https://x.com/i/lists/{id}`.
`data.createdAt`	string (date-time)	yes
`data.memberCount`	integer	yes	min 0
`data.subscriberCount`	integer	yes	Accounts following the list. · min 0
`data.ownerId`	string	yes
`data.owner`	object or null	yes	The list's owner. Null only when X omits it.
`data.owner.id`	string	yes
`data.owner.username`	string	yes
`data.owner.name`	string	yes
`data.owner.verified`	boolean	yes
`data.owner.followersCount`	integer	yes	min 0
`data.owner.profileImageUrl`	string or null	yes
`meta`	object	yes
`meta.requestId`	string	yes
`meta.nextCursor`	string or null	no

Errors

Status	Meaning	What to do
`400`	The request failed validation.	The request was malformed. The `details` object names the field.
`401`	The API key is missing, malformed, expired, or revoked.	The key is missing, malformed, revoked, or expired.
`402`	The account is out of credit. Not retryable: this cannot clear until the billing period resets or the plan changes.	Out of credits. Never retry. Only a person can clear it, by adding credits at https://weirapp.io/dashboard/billing. Retrying never will.
`403`	The API key does not carry the scope this route requires.	The key is valid but lacks the scope this operation needs.
`404`	The requested resource does not exist.	No such resource, or it is not public.
`429`	The per-minute rate limit is exhausted. Retryable: wait for Retry-After and try again.	Rate limited. Retryable: wait for `Retry-After`, then try again.
`500`	An unexpected error occurred.	Something failed on our side. Retryable with backoff.
`503`	The source is temporarily unavailable. The request is safe to retry.	A source was unreachable. Retryable with backoff.