---
title: "Get thread"
method: GET
path: "/threads/{id}"
tags: ["threads"]
---

# Get thread

`GET /threads/{id}`

## Request

- Base URL: `https://productlane.com/api/v1`
- URL: `https://productlane.com/api/v1/threads/{id}`
- Auth: HTTP bearer

Get thread by ID. Authentication is required.

## Path parameters

- `id` string, required

## Query parameters

- `includeConversation` 'true' | 'false'

## Response `200`

Successful response

- object
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `isDeleted` boolean, required
  - `isRead` boolean, required
  - `lastInboundMessageAt` string, date-time, nullable, required
  - `lastOutboundMessageAt` string, date-time, nullable, required
  - `lastStateChangeAt` string, date-time, nullable, required
  - `text` string, required
  - `painLevel` 'UNKNOWN' | 'LOW' | 'MEDIUM' | 'HIGH', required
  - `state` 'NEW' | 'PROCESSED' | 'COMPLETED' | 'SNOOZED' | 'UNSNOOZED', required
  - `origin` 'INAPP' | 'PORTAL' | 'SUPPORT_PORTAL' | 'API' | 'SLACK' | 'SLACK_CONNECT' | 'INTERCOM' | 'INTERCOM_ATTACHMENT' | 'ZENDESK_ATTACHMENT' | 'ZENDESK' | 'FRONT_ATTACHMENT' | 'EMAIL' | 'ZAPIER' | 'HUBSPOT' | 'PLAIN' | 'CALENDAR' | 'WIDGET' | 'AI_CHAT' | 'UPVOTE' | 'LIVE_CHAT' | 'TEAMS' | 'LINEAR' | 'CUSTOM', required
  - `title` string, nullable, required
  - `snoozedUntil` string, date-time, nullable, required
  - `workspaceId` string, required
  - `contactId` string, nullable, required
  - `companyId` string, nullable, required
  - `reporterId` string, nullable, required
  - `assigneeId` string, nullable, required
  - `attachments` unknown[], required
    - unknown
  - `recordingId` string, nullable, required
  - `videoId` string, nullable, required
  - `slackChannelId` string, nullable, required
  - `linearAttachmentId` string, nullable, required
  - `intercomId` string, nullable, required
  - `frontId` string, nullable, required
  - `zendeskId` string, nullable, required
  - `hubspotId` string, nullable, required
  - `plainId` string, nullable, required
  - `productboardId` string, nullable, required
  - `slackReplyId` string, nullable, required
  - `uniqueId` string, nullable, required
  - `customerNeeds` object[], required
    - `id` string, required
    - `feedbackId` string, required
    - `projectId` string, nullable, required
    - `issueId` string, nullable, required
    - `linearCustomerNeedId` string, required
    - `priority` number, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `contact` object, nullable, required
    - `id` string, required
    - `email` string, required
    - `name` string, nullable, required
    - `imageUrl` string, nullable, required
    - `companyId` string, nullable, required
    - `workspaceId` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `isDeleted` boolean, required
    - `version` number, required
    - `intercomId` string, nullable
    - `hubspotId` string, nullable
    - `productboardId` string, nullable
    - `zendeskId` string, nullable
  - `company` object, nullable, required
    - `id` string, required
    - `name` string, required
    - `workspaceId` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `isDeleted` boolean, required
    - `version` number, required
    - `linearCustomerId` string, nullable, required
    - `size` number, nullable, required
    - `revenue` number, nullable, required
    - `statusId` string, nullable, required
    - `statusName` string, nullable, required
    - `statusColor` string, nullable, required
    - `tierId` string, nullable, required
    - `tierName` string, nullable, required
    - `logoUrl` string, nullable, required
    - `domains` string[], required
    - `autoAdd` boolean, nullable, required
    - `intercomId` string, nullable, required
    - `hubspotId` string, nullable, required
    - `productboardId` string, nullable, required
    - `externalIds` string[], required
    - `slugId` string, nullable, required
  - `tags` object[], required
    - `id` string, required
    - `name` string, required
    - `color` string, required
    - `icon` string, required
    - `tagGroupId` string, nullable, required
  - `assignee` object, nullable, required
    - `id` string, required
    - `name` string, nullable, required
    - `email` string, nullable, required
    - `role` string, nullable, required
    - `imageUrl` string, nullable, required
    - `selectedTeamIds` string[]
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `reporter` object, nullable, required
    - `id` string, required
    - `name` string, nullable, required
    - `email` string, nullable, required
    - `role` string, nullable, required
    - `imageUrl` string, nullable, required
    - `selectedTeamIds` string[]
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `conversation` union[]
    - union
      - object
        - `id` string, required
        - `timestamp` string, date-time, required
        - `type` 'email', required
        - `data` object, required
          - `id` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `date` string, date-time, required
          - `isDeleted` boolean, required
          - `type` string, required
          - `subject` string, required
          - `originalRecipient` string, required
          - `from` unknown
          - `to` unknown[], required
            - unknown
          - `cc` unknown[], required
            - unknown
          - `bcc` unknown[], required
            - unknown
          - `attachments` unknown[], required
            - unknown
          - `textContent` string, required
          - `htmlContent` string, required
          - `postmarkMessageId` string, nullable, required
          - `messageId` string, nullable, required
          - `uniqueId` string, nullable, required
          - `threadId` string, required
          - `workspaceId` string, required
          - `userId` string, nullable, required
      - object
        - `id` string, required
        - `timestamp` string, date-time, required
        - `type` 'slack', required
        - `data` object, required
          - `id` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `isDeleted` boolean, required
          - `type` string, required
          - `teamId` string, required
          - `channelId` string, required
          - `slackId` string, required
          - `slackUserId` string, required
          - `slackThreadId` string, nullable, required
          - `text` string, required
          - `slackLink` string, required
          - `attachments` unknown[], required
            - unknown
          - `html` string, required
          - `workspaceId` string, required
          - `threadId` string, required
          - `userId` string, nullable, required
      - object
        - `id` string, required
        - `timestamp` string, date-time, required
        - `type` 'liveChat', required
        - `data` object, required
          - `id` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `isDeleted` boolean, required
          - `content` string, required
          - `role` string, required
          - `attachments` unknown[], required
            - unknown
          - `email` string, nullable, required
          - `name` string, nullable, required
          - `imageUrl` string, nullable, required
          - `sessionId` string, required
      - object
        - `id` string, required
        - `timestamp` string, date-time, required
        - `type` 'comment', required
        - `data` object, required
          - `id` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `isDeleted` boolean, required
          - `content` string, required
          - `attachments` unknown[], required
            - unknown
          - `feedbackId` string, required
          - `workspaceId` string, required
          - `userId` string, nullable, required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/productlane/apis/productlane-api.md) · [All operations](https://skmtc.dev/productlane/apis/productlane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/productlane/apis/productlane-api/revisions/9325a8425b36?raw)