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

# Get thread details

> **Get metadata for a specific conversation thread**

Returns lead info, campaign, subject, read/star state, category, and reply count.



## OpenAPI

````yaml /public_openapi.json get /api/public/v1/replies/threads/{thread_id}
openapi: 3.0.3
info:
  title: ColdSend Public API
  description: >-
    Programmatic access to ColdSend for managing cold email campaigns and sender
    accounts.
  version: 1.0.0
  contact:
    name: ColdSend Support
    email: support@coldsend.pro
    url: https://coldsend.pro
servers:
  - url: https://api.coldsend.pro
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /api/public/v1/replies/threads/{thread_id}:
    get:
      tags:
        - Replies
      summary: Get thread details
      description: >-
        **Get metadata for a specific conversation thread**


        Returns lead info, campaign, subject, read/star state, category, and
        reply count.
      operationId: get_thread_details_api_public_v1_replies_threads__thread_id__get
      parameters:
        - name: thread_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: Thread ID
            title: Thread Id
          description: Thread ID
      responses:
        '200':
          description: Thread details retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThreadDetailsResponse'
        '401':
          description: Missing or invalid API key
        '403':
          description: Insufficient permissions – requires 'replies:read' scope
        '404':
          description: Thread not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ThreadDetailsResponse:
      properties:
        thread_id:
          type: string
          title: Thread Id
          description: Thread ID
        lead_id:
          type: string
          title: Lead Id
          description: Lead ID
        inbox_id:
          type: string
          nullable: true
          title: Inbox Id
          description: Inbox ID (None for archived threads)
        campaign_id:
          type: string
          nullable: true
          title: Campaign Id
          description: Campaign ID (None for external threads)
        lead_email:
          type: string
          title: Lead Email
          description: Lead email address
        lead_name:
          type: string
          title: Lead Name
          description: Lead display name
        inbox_email:
          type: string
          nullable: true
          title: Inbox Email
          description: Inbox email address (None for archived threads)
        campaign_name:
          type: string
          title: Campaign Name
          description: Campaign name (External for non-campaign threads)
        from_address:
          type: string
          title: From Address
          description: Thread from address
        to_address:
          type: string
          title: To Address
          description: Thread to address
        subject:
          type: string
          title: Subject
          description: Original subject
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Thread creation time
        is_read:
          type: boolean
          title: Is Read
          description: Whether thread is read
        is_starred:
          type: boolean
          title: Is Starred
          description: Whether thread is starred
        reply_count:
          type: integer
          title: Reply Count
          description: Number of replies
        category:
          type: string
          nullable: true
          title: Category
          description: Effective category (manual or AI)
        ai_category:
          type: string
          nullable: true
          title: Ai Category
          description: AI-assigned category
        ai_confidence:
          type: number
          nullable: true
          title: Ai Confidence
          description: AI confidence score
        manual_category:
          type: string
          nullable: true
          title: Manual Category
          description: Manually assigned category
        tags:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Tags
          description: Tags applied to this thread
          default: []
        is_archived:
          type: boolean
          title: Is Archived
          description: Whether thread is archived (domain deleted)
          default: false
        archived_domain_name:
          type: string
          nullable: true
          title: Archived Domain Name
          description: Name of deleted domain
        archived_inbox_email:
          type: string
          nullable: true
          title: Archived Inbox Email
          description: Email of deleted inbox
        archived_at:
          type: string
          format: date-time
          nullable: true
          title: Archived At
          description: When thread was archived
      type: object
      required:
        - thread_id
        - lead_id
        - lead_email
        - lead_name
        - campaign_name
        - from_address
        - to_address
        - subject
        - created_at
        - is_read
        - is_starred
        - reply_count
      title: ThreadDetailsResponse
      description: Response schema for detailed thread information.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key with format cs_live_xxx

````