---
title: "Get all threads"
method: GET
path: "/public/v1/threads"
tags: ["public"]
---

# Get all threads

`GET /public/v1/threads`

## Request

- Base URL: `https://api.gurusup.com`
- URL: `https://api.gurusup.com/public/v1/threads`
- Auth: API key in header `x-api-key`

Retrieve a list of threads for the authenticated organization.

## Query parameters

- `status` string, nullable
- `from_date` string, date-time, nullable
- `to_date` string, date-time, nullable
- `source` string, nullable
- `agent_id` string, nullable
- `last_sender_address` string, nullable
- `skip` integer
- `limit` integer

## Response `200`

A list of threads associated with the organization.

- ThreadListItem[]
  - `id` string, required: Thread hash identifier
  - `thread_fid` string, required: Thread foreign ID
  - `subject` string, nullable: Thread subject
  - `status` string, required: Thread status (needs_review, auto_answered, archived)
  - `source` string, nullable: Integration source (WHATSAPP, GMAIL, API)
  - `last_sender_name` string, nullable: Name of the last sender
  - `last_sender_address` string, nullable: Email or phone of the last sender
  - `last_message_timestamp` string, date-time, required: Timestamp of the last message
  - `last_message_body` string, nullable: Preview of the last message (truncated)
  - `read` boolean: Whether the thread has been read
  - `language` string: Detected language
  - `thread_format` string, nullable: Thread format (email, whatsapp, etc)
  - `involved_agents` string[], nullable: List of agents involved in the thread
  - `sender` string, nullable: Sender of the thread

## Other responses

- `422`: Validation Error

---

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