> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt > Use this file to discover all available pages before exploring further. # Get List Details > Get detailed information about a Twitter list. Returns comprehensive list details including name, description, member count, subscriber count, visibility mode, and owner information. Useful for understanding list composition before fetching its tweets. ## OpenAPI ````yaml get /v1/twitter/lists/{list_id}/detail openapi: 3.1.0 info: title: ScrapeBadger Twitter API description: >- The ScrapeBadger Twitter API provides programmatic access to Twitter/X data through a simple REST interface. Retrieve tweets, user profiles, followers, lists, communities, trends, and geographic data — all with a single API key. All endpoints require authentication via the `x-api-key` header. Each request consumes credits from your account balance. Paginated endpoints return a `next_cursor` field that you can pass to subsequent requests to retrieve additional pages of results. **Base URL:** `https://scrapebadger.com/v1/twitter` **Rate Limits:** Requests are rate-limited per API key. If you exceed your limit, you will receive a `429` response. Implement exponential backoff and retry logic for production use. **Credits:** Each successful API call deducts credits from your balance. If your balance reaches zero, subsequent requests will return `402 Payment Required`. version: 1.0.0 contact: name: ScrapeBadger Support url: https://scrapebadger.com email: support@scrapebadger.com servers: - url: https://scrapebadger.com description: Production security: - apiKey: [] tags: - name: Tweets description: >- Retrieve tweets, search tweets, and access tweet metadata including replies, quotes, retweeters, favoriters, edit history, and community notes. - name: Users description: >- Retrieve user profiles, followers, following lists, mentions, subscriptions, and search for users. - name: Lists description: Access Twitter list details, list tweets, and search within lists. - name: Communities description: Retrieve community details, community tweets, and search for communities. - name: Trends description: Get trending topics globally or by location. - name: Geo description: Search for geographic places and retrieve place details. - name: Spaces description: Access Twitter Spaces and live broadcast details. - name: Stream Monitors description: >- Create and manage real-time stream monitors that track Twitter accounts and deliver new tweets via WebSocket or webhook. - name: Stream Webhooks description: >- Manage webhook endpoints for stream monitor delivery. Webhooks receive HMAC-SHA256 signed payloads when new tweets are detected. - name: Stream Logs description: >- Access delivery logs and billing logs for stream monitors. Track tweet detection latency, webhook delivery status, and credit consumption. - name: Filter Rules description: >- Create and manage filter rules that monitor Twitter using Advanced Search queries at configurable intervals. Delivered via WebSocket or webhook. paths: /v1/twitter/lists/{list_id}/detail: get: tags: - Lists summary: Get list details description: >- Get detailed information about a Twitter list. Returns comprehensive list details including name, description, member count, subscriber count, visibility mode, and owner information. Useful for understanding list composition before fetching its tweets. operationId: getListDetail parameters: - name: list_id in: path required: true description: The unique numeric ID of the list. schema: type: string example: '1580582120482430976' responses: '200': description: Successfully retrieved list details. content: application/json: schema: $ref: '#/components/schemas/ListData' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '429': $ref: '#/components/responses/RateLimitExceeded' components: schemas: ListData: type: object description: Twitter list metadata. required: - id - name properties: id: type: string description: Unique list identifier. example: '1580582120482430976' name: type: string description: Name of the list. example: Tech Leaders description: type: - string - 'null' description: Description of the list. created_at: type: - string - 'null' description: Timestamp when the list was created. member_count: type: - integer - 'null' description: Number of members in the list. subscriber_count: type: - integer - 'null' description: Number of subscribers to the list. mode: type: - string - 'null' description: Visibility mode of the list. enum: - public - private user_id: type: - string - 'null' description: Numeric ID of the list owner. username: type: - string - 'null' description: Username of the list owner. ErrorResponse: type: object description: Error response returned for failed requests. required: - error properties: error: type: string description: Human-readable error message describing what went wrong. responses: Unauthorized: description: Authentication failed. The API key is missing, invalid, or expired. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Invalid or missing API key PaymentRequired: description: >- Insufficient credits. Your account balance has been exhausted. Purchase more credits at https://scrapebadger.com/dashboard/billing. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Insufficient credits RateLimitExceeded: description: >- Rate limit exceeded. Too many requests in a given time period. Implement exponential backoff and retry. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Rate limit exceeded. Please retry after a short delay. securitySchemes: apiKey: type: apiKey name: x-api-key in: header description: >- Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys. ````