> ## 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 messages > **Get the full message history for a conversation thread** Returns all messages in chronological order including: - Initial campaign email(s) - Sequence follow-up email(s) - Incoming replies from the lead - Outgoing replies from your team ## OpenAPI ````yaml /public_openapi.json get /api/public/v1/replies/threads/{thread_id}/messages 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}/messages: get: tags: - Replies summary: Get thread messages description: |- **Get the full message history for a conversation thread** Returns all messages in chronological order including: - Initial campaign email(s) - Sequence follow-up email(s) - Incoming replies from the lead - Outgoing replies from your team operationId: >- get_thread_messages_api_public_v1_replies_threads__thread_id__messages_get parameters: - name: thread_id in: path required: true schema: type: string format: uuid description: Thread ID title: Thread Id description: Thread ID - 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: 100 minimum: 1 description: Items per page default: 50 title: Limit description: Items per page responses: '200': description: Thread messages retrieved content: application/json: schema: $ref: '#/components/schemas/ReplyListResponse' '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: ReplyListResponse: properties: success: type: boolean title: Success message: type: string title: Message thread_id: type: string title: Thread Id description: Thread ID messages: items: $ref: '#/components/schemas/ReplyMessageResponse' type: array title: Messages description: List of messages total_count: type: integer title: Total Count description: Total number of messages page: type: integer title: Page description: Current page number limit: type: integer title: Limit description: Items per page total_pages: type: integer title: Total Pages description: Total number of pages has_next: type: boolean title: Has Next description: Whether there are more pages has_prev: type: boolean title: Has Prev description: Whether there are previous pages type: object required: - success - message - thread_id - messages - total_count - page - limit - total_pages - has_next - has_prev title: ReplyListResponse description: Response for listing replies in a thread. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ReplyMessageResponse: properties: reply_id: type: string title: Reply Id description: Reply ID from_email: type: string title: From Email description: Sender email to_email: type: string title: To Email description: Recipient email subject: type: string title: Subject description: Reply subject body_text: type: string nullable: true title: Body Text description: Plain text body body_html: type: string nullable: true title: Body Html description: HTML body is_outgoing: type: boolean title: Is Outgoing description: Whether this is an outgoing reply is_read: type: boolean title: Is Read description: Whether reply is read created_at: type: string format: date-time title: Created At description: Reply timestamp message_id: type: string nullable: true title: Message Id description: Email Message-ID attachments: items: $ref: '#/components/schemas/AttachmentMetadata' type: array nullable: true title: Attachments description: Attachment metadata list bounce_category: type: string nullable: true title: Bounce Category description: >- Bounce category (e.g., AUTORESPONDER) if this reply was classified as a bounce/auto-reply type: object required: - reply_id - from_email - to_email - subject - body_text - body_html - is_outgoing - is_read - created_at - message_id title: ReplyMessageResponse description: Response schema for a single reply message. 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 AttachmentMetadata: properties: filename: type: string title: Filename description: Attachment file name content_type: type: string title: Content Type description: MIME content type size_bytes: type: integer title: Size Bytes description: File size in bytes gcs_path: type: string nullable: true title: Gcs Path description: GCS blob path for download url: type: string nullable: true title: Url description: Signed download URL (generated on read) type: object required: - filename - content_type - size_bytes title: AttachmentMetadata description: Schema for attachment metadata stored in the database. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key with format cs_live_xxx ````