> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consensus.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List historical Threads

> The caller's prior Threads, newest first, optionally filtered by a case-insensitive title substring. Rate limit: 1 request/second. On this list, status may be absent for Threads inactive past the status window and title is substituted when the Thread has none; GET the Thread for authoritative status and title.



## OpenAPI

````yaml /openapi.json get /v1/threads
openapi: 3.1.0
info:
  title: Consensus API
  description: >-
    Search usage is billed in calls: one call per 100 papers returned, rounded
    up, with a minimum of 1 call per request. Usage counts against your plan's
    included monthly calls. Free plans include 30 calls per month, Pro and Teams
    plans include 500, and Deep plans include 2,000. Paid plans with an active
    metered API subscription may continue past the included limit; additional
    calls are billed at $0.05 per call. Enterprise API keys have unlimited
    access.
  version: '1.0'
servers:
  - url: https://api.consensus.app
security: []
paths:
  /v1/threads:
    get:
      summary: List historical Threads
      description: >-
        The caller's prior Threads, newest first, optionally filtered by a
        case-insensitive title substring. Rate limit: 1 request/second. On this
        list, status may be absent for Threads inactive past the status window
        and title is substituted when the Thread has none; GET the Thread for
        authoritative status and title.
      operationId: v1_list_threads
      parameters:
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Title substring to match (case-insensitive).
            title: Query
          description: Title substring to match (case-insensitive).
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Max Threads to return.
            default: 20
            title: Limit
          description: Max Threads to return.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Pagination offset.
            default: 0
            title: Offset
          description: Pagination offset.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThreadListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - XApiKeyHeader: []
components:
  schemas:
    ThreadListResponse:
      properties:
        threads:
          items:
            $ref: '#/components/schemas/ThreadListItem'
          type: array
          title: Threads
        has_more:
          type: boolean
          title: Has More
      type: object
      required:
        - threads
        - has_more
      title: ThreadListResponse
      description: GET /v1/threads — the caller's Threads, newest first.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ThreadListItem:
      properties:
        thread_id:
          type: string
          title: Thread Id
        title:
          type: string
          title: Title
        status:
          anyOf:
            - type: string
              enum:
                - running
                - idle
                - failed
            - type: 'null'
          title: Status
          description: >-
            Latest interaction's status when known; omitted for Threads inactive
            past the status window. `GET /v1/threads/{thread_id}` is
            authoritative.
        preview:
          anyOf:
            - type: string
            - type: 'null'
          title: Preview
          description: First ~500 chars of the latest answer.
        interaction_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Interaction Count
        last_activity_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Activity At
        url:
          type: string
          title: Url
      type: object
      required:
        - thread_id
        - title
        - url
      title: ThreadListItem
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    XApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.