{"uid":"cap_GUNWnb_W3ERI-qvrb6XUx","slug":"twitter-x-list-details-2e049ef2","name":"Twitter/X List Details","description":"Get complete public information for an X list.","url":"https://twitter.use.x402atlas.com/list-details","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["list_id"],"properties":{"list_id":{"type":"string","pattern":"^[0-9]{1,25}$","maxLength":25,"description":"Decimal X list identifier"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data"],"properties":{"data":{"type":"object","additionalProperties":true},"cursor":{"type":"string","description":"Opaque cursor for the next page, when supplied by X"},"queried_at":{"type":"string","format":"date-time"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"name":"Technology","id_str":"1309482935804932102","description":"Technology accounts and news","member_count":120,"subscriber_count":4500},"queried_at":"2026-07-26T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_on5-D7lLqmezrDgOgsQ6U","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves complete public metadata and information for a specific X (Twitter) list by its numeric list ID.","exampleAgentPrompt":"Can you pull up the full details for X list ID 1234567890 — I want to know the name, description, owner, and member count?","exampleUseCases":[{"title":"Researching a curated influencer list","prompt":"I found a Twitter list that seems to track top AI researchers — the list ID is 84839587. Can you get me the full details on it, like who made it, what the description says, and how many members are on it?"},{"title":"Validating a list before subscription","prompt":"Before I subscribe to X list 1923847561, can you fetch its complete info so I can see the name, owner, and whether it's actually public?"},{"title":"Monitoring list metadata for changes","prompt":"Pull up the current details for X list ID 748291034 — I want to capture the member count, description, and owner details so I can track if anything changes over time."}],"resultDescription":"Returns a JSON object containing the complete public metadata for the specified X list, including fields such as list name, description, owner account info, member and subscriber counts, visibility (public/private), creation timestamp, and any other available profile data. Also includes a queried_at timestamp indicating when the data was fetched.","failureModes":["Invalid list_id format (non-numeric or too long) returns a validation error","List ID does not exist or has been deleted returns a not-found error","List is private or restricted and not accessible to the API returns an access error","Rate limiting by the upstream X API causes temporary failures","Network timeout if X API is slow to respond"],"whenToPreferThis":"Use this endpoint when you need complete metadata about a specific X list and already have its numeric list ID. It is ideal for verifying list existence, reading owner and description details, or enriching data pipelines with list profile information. Prefer this over search-based endpoints when you have the exact list ID and need authoritative, structured list data rather than search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:57.392Z","isFirstParty":false}