> ## 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. # List conversations > **List all reply conversations for your workspace** Returns a paginated list of incoming reply threads across all campaigns. ## Filtering - **campaign_id**: Restrict to a specific campaign - **status**: Filter by read state — `unread`, `read`, or `starred` - **search**: Full-text search against lead name, lead email, and subject ## Pagination Default page size is 50, maximum is 200. ## OpenAPI ````yaml /public_openapi.json get /api/public/v1/replies 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: get: tags: - Replies summary: List conversations description: >- **List all reply conversations for your workspace** Returns a paginated list of incoming reply threads across all campaigns. ## Filtering - **campaign_id**: Restrict to a specific campaign - **status**: Filter by read state — `unread`, `read`, or `starred` - **search**: Full-text search against lead name, lead email, and subject ## Pagination Default page size is 50, maximum is 200. operationId: list_conversations_api_public_v1_replies_get parameters: - name: campaign_id in: query required: false schema: type: string format: uuid nullable: true title: Campaign Id description: Filter by campaign ID description: Filter by campaign ID - name: status in: query required: false schema: type: string nullable: true title: Status description: 'Filter by status: unread, read, starred' description: 'Filter by status: unread, read, starred' - name: search in: query required: false schema: type: string nullable: true title: Search description: Search by lead name, email, or subject description: Search by lead name, email, or subject - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 description: Items per page default: 50 title: Limit description: Items per page responses: '200': description: Conversations retrieved content: application/json: schema: $ref: '#/components/schemas/PublicConversationsResponse' '401': description: Missing or invalid API key '403': description: Insufficient permissions – requires 'replies:read' scope '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: PublicConversationsResponse: properties: success: type: boolean title: Success message: type: string title: Message threads: items: $ref: '#/components/schemas/PublicThreadItem' type: array title: Threads description: List of conversation threads total_count: type: integer title: Total Count description: Total matching threads page: type: integer title: Page description: Current page limit: type: integer title: Limit description: Items per page total_pages: type: integer title: Total Pages description: Total pages has_next: type: boolean title: Has Next description: Whether more pages exist has_prev: type: boolean title: Has Prev description: Whether a previous page exists unread_count: type: integer title: Unread Count description: Number of unread threads in the current result set starred_count: type: integer title: Starred Count description: Number of starred threads in the current result set type: object required: - success - message - threads - total_count - page - limit - total_pages - has_next - has_prev - unread_count - starred_count title: PublicConversationsResponse description: Paginated list of conversation threads. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PublicThreadItem: properties: thread_id: type: string title: Thread Id description: Thread ID lead_id: type: string nullable: true title: Lead Id description: Lead ID inbox_id: type: string nullable: true title: Inbox Id description: Inbox ID lead_email: type: string title: Lead Email description: Lead email address lead_name: type: string title: Lead Name description: Lead display name campaign_name: type: string title: Campaign Name description: Campaign name ('External' for non-campaign threads) subject: type: string title: Subject description: Thread subject last_message_preview: type: string title: Last Message Preview description: Preview of the last message (up to 100 chars) last_message_at: type: string format: date-time title: Last Message At description: Timestamp of last message is_read: type: boolean title: Is Read description: Whether the thread has been read is_starred: type: boolean title: Is Starred description: Whether the thread is starred reply_count: type: integer title: Reply Count description: Number of replies in this thread category: type: string nullable: true title: Category description: >- Conversation category (e.g. INTERESTED, NOT_INTERESTED, BOUNCE_NOTICE) type: object required: - thread_id - lead_email - lead_name - campaign_name - subject - last_message_preview - last_message_at - is_read - is_starred - reply_count title: PublicThreadItem description: Lightweight representation of a single conversation thread. 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 ````