# Retrieve thread

div
strong
🔨 In Development
 — This section is still being developed and may change.


Get detailed information about a specific thread including metadata, message count, and configuration.

Get detailed information about a specific thread including metadata, message count, and configuration. Returns complete thread details with all associated metadata and settings.

#### Path Parameters

**`thread_id`** string required

The unique identifier of the thread to retrieve.

Request

```bash
curl "https://api.freddy.aitronos.com/v1/threads/thread_abc123" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/threads/thread_abc123",
    headers={"Authorization": f"Bearer {api_key}"}
)

thread = response.json()
print(f"Thread: {thread['title']} ({thread['messageCount']} messages)")
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/threads/thread_abc123', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const thread = await response.json();
console.log(`Thread: ${thread.title} (${thread.messageCount} messages)`);
```

## Response

200 OK

```json
{
  "id": "thread_abc123",
  "object": "thread",
  "createdAt": 1741476542,
  "updatedAt": 1741476600,
  "metadata": {
    "category": "support",
    "priority": "high",
    "tags": ["billing", "urgent"]
  },
  "assistantId": "asst_support_agent",
  "organizationId": "ORG_123",
  "userId": "uid_user123",
  "title": "Customer Support Query",
  "visibleInUi": true,
  "messageCount": 5,
  "status": "inactive"
}
```

Errors

```json 404 Not Found
{
  "error": {
    "message": "Thread not found or access denied",
    "type": "not_found_error",
    "code": "thread_not_found"
  }
}
```


```json 401 Unauthorized
{
  "error": {
    "message": "Authentication required",
    "type": "authentication_error",
    "code": "missing_authentication"
  }
}
```


```json 403 Forbidden
{
  "error": {
    "message": "Access denied to thread",
    "type": "permission_error",
    "code": "insufficient_permissions"
  }
}
```

## Related Resources

- [Threads Overview](/docs/documentation/core-concepts/threads-overview)
- [List Threads](/docs/api-reference/threads/list)
- [Update Thread](/docs/api-reference/threads/update)
- [Thread Context Modes](/docs/documentation/core-concepts/thread-context-modes)