> ## Documentation Index > Fetch the complete documentation index at: https://docs.api.stuut.co/llms.txt > Use this file to discover all available pages before exploring further. # List Email Threads > List Email Threads ## OpenAPI ````yaml https://api.stuut.ai/openapi.json get /v2/email-threads openapi: 3.1.0 info: title: Stuut API termsOfService: https://stuut.ai/terms-and-conditions contact: name: Stuut Support url: https://stuut.ai/ email: devs@stuut.co version: 2.0.0 servers: [] security: - HTTPBearer: [] tags: - name: adjustments description: Operations for managing payment adjustments (fees, discounts, write-offs). x-displayName: Adjustments - name: aether description: Operations for aether. x-displayName: Aether - name: analytics description: Operations for retrieving analytics and dashboard data. x-displayName: Analytics - name: assistant description: Operations for the in-app chat assistant. x-displayName: Assistant - name: audit-log description: Operations for retrieving the organization's audit log. x-displayName: Audit Log - name: bank-accounts description: Operations for retrieving and managing bank accounts. x-displayName: Bank Accounts - name: bank-statements description: Operations for retrieving and managing bank statements. x-displayName: Bank Statements - name: bank-transactions description: Operations for retrieving and managing bank transactions. x-displayName: Bank Transactions - name: business-units description: Operations for listing and managing business units. x-displayName: Business Units - name: call-agent description: >- Operations for initiating and managing real-time voice calls with partners. x-displayName: Call Agent - name: calls description: Operations for retrieving and managing voice call records. x-displayName: Calls - name: cash-app description: Operations for cash application — matching incoming payments to invoices. x-displayName: Cash Application - name: chats description: Operations for managing chat conversations. x-displayName: Chats - name: cnam-registration description: Operations for managing CNAM (caller ID name) registration. x-displayName: CNAM Registration - name: credit-memos description: Operations for retrieving and searching credit memos. x-displayName: Credit Memos - name: custom-table-templates description: >- Operations for managing custom table templates used in email template variables. x-displayName: Custom Table Templates - name: customer-segments description: Operations for managing customer segments. x-displayName: Customer Segments - name: deductions-knowledge description: Operations for managing deduction processing knowledge entries. x-displayName: Deductions Knowledge - name: email-threads description: Operations for managing email threads. x-displayName: Email Threads - name: emails description: Operations for retrieving and managing emails. x-displayName: Emails - name: exports description: Operations for requesting and retrieving async data exports. x-displayName: Exports - name: integrations description: >- Operations for managing integrations with external systems (e.g. ERP, CRM, etc.). x-displayName: Integrations - name: internal-contacts description: >- Operations for managing internal contacts (CSMs, account managers, etc.) and their assignments to partners. x-displayName: Internal Contacts - name: invoices description: Operations for retrieving and managing invoices. x-displayName: Invoices - name: kyb description: Operations for Know Your Business (KYB) verification. x-displayName: KYB - name: ledger-accounts description: Operations for retrieving and managing ledger accounts. x-displayName: Ledger Accounts - name: mailbox-settings description: >- Operations for an organization's mailbox provider configuration: Microsoft admin consent, shared-mailbox discovery, and provider health. x-displayName: Mailbox Settings - name: mailboxes description: >- Operations for connecting, listing, updating, and archiving user and shared mailboxes, including delegated OAuth sign-in. x-displayName: Mailboxes - name: media description: >- Operations for signing direct-to-storage media uploads (e.g. signature images). x-displayName: Media - name: organizations description: Operations for retrieving and managing the current organization. x-displayName: Organizations - name: outreach-workflows description: Operations for managing automated collections outreach workflows. x-displayName: Outreach Workflows - name: partners description: Operations for retrieving and managing customers. x-displayName: Partners - name: payments description: Operations for approving and managing payments. x-displayName: Payments - name: report-configs description: >- Operations for managing report configurations (frequency, recipients, schedule). x-displayName: Report Configs - name: sms-campaign-registration description: Operations for managing A2P 10DLC SMS campaign registration. x-displayName: SMS Campaign Registration - name: sms-templates description: >- Operations for defining, storing, and managing parameterized SMS message templates. x-displayName: SMS Templates - name: sms-threads description: Operations for retrieving and managing SMS conversation threads. x-displayName: SMS Threads - name: users description: Operations for retrieving and managing users. x-displayName: Users - name: users-ooo description: Operations for managing user out-of-office (OOO) status and coverage. x-displayName: Users OOO paths: /v2/email-threads: get: tags: - email-threads summary: List Email Threads description: List Email Threads operationId: GetEmailThreads parameters: - name: page in: query required: false schema: type: integer minimum: 0 description: Page number, 0 indexed. default: 0 description: Page number, 0 indexed. - name: limit in: query required: false schema: type: integer maximum: 500 minimum: 1 description: Number of records per page. default: 100 description: Number of records per page. - name: category in: query required: false schema: anyOf: - $ref: '#/components/schemas/EmailThreadCategories' - type: 'null' description: 'Filter threads by category: drafts, unread, sent, or all.' description: 'Filter threads by category: drafts, unread, sent, or all.' - name: partner_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter threads by partner ID. description: Filter threads by partner ID. - name: invoice_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter threads by invoice ID. description: Filter threads by invoice ID. - name: workflow_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter threads by workflow ID. description: Filter threads by workflow ID. - name: business_unit_id__in in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: >- Filter threads by business unit IDs. Independent of the user's BU visibility scope, which is always enforced. description: >- Filter threads by business unit IDs. Independent of the user's BU visibility scope, which is always enforced. - name: assignee in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter by partner assignee user ID. Empty string filters to unassigned threads. description: >- Filter by partner assignee user ID. Empty string filters to unassigned threads. - name: has_responses in: query required: false schema: anyOf: - type: boolean - type: 'null' description: >- True: threads with more than one email; False: single-email threads. description: 'True: threads with more than one email; False: single-email threads.' - name: read in: query required: false schema: anyOf: - type: boolean - type: 'null' description: >- True: no unread inbound emails; False: at least one unread inbound email. description: >- True: no unread inbound emails; False: at least one unread inbound email. - name: has_open_tasks in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter threads by whether they have any open tasks. description: Filter threads by whether they have any open tasks. - name: triage_status in: query required: false schema: anyOf: - $ref: '#/components/schemas/EmailThreadTriageStatus' - type: 'null' description: >- Filter to threads in a specific triage state. Takes precedence over is_triaged and triaged_by__in. description: >- Filter to threads in a specific triage state. Takes precedence over is_triaged and triaged_by__in. - name: is_triaged in: query required: false schema: anyOf: - type: boolean - type: 'null' description: >- True: AUTO_MATCHED or MANUALLY_MATCHED; False: PENDING. Ignored when triage_status is set. description: >- True: AUTO_MATCHED or MANUALLY_MATCHED; False: PENDING. Ignored when triage_status is set. - name: triaged_by__in in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: >- Filter resolved triage threads by the actor that resolved them. Use TRIAGE_AI_ACTOR_ID for AI-resolved. description: >- Filter resolved triage threads by the actor that resolved them. Use TRIAGE_AI_ACTOR_ID for AI-resolved. - name: is_from_centralized_inbox in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter threads to those from (or not from) the centralized inbox. description: Filter threads to those from (or not from) the centralized inbox. - name: is_internal in: query required: false schema: anyOf: - type: boolean - type: 'null' description: >- True: show only internal-to-internal threads (every address on every email belongs to the org). When True, bypasses the default partner_id requirement since internal threads have no partner. False/None: existing behavior. description: >- True: show only internal-to-internal threads (every address on every email belongs to the org). When True, bypasses the default partner_id requirement since internal threads have no partner. False/None: existing behavior. - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search threads by partner name or email. description: Search threads by partner name or email. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_EmailThreadSummary_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: EmailThreadCategories: type: string enum: - all - drafts - sent - unread title: EmailThreadCategories EmailThreadTriageStatus: type: string enum: - pending - auto_matched - manually_matched - dismissed title: EmailThreadTriageStatus PaginatedResponse_EmailThreadSummary_: properties: data: items: $ref: '#/components/schemas/EmailThreadSummary' type: array title: '' description: The list of records. current_page: type: integer title: '' description: The current page. default: 0 total_records: anyOf: - type: integer minimum: 0 - type: 'null' title: '' description: Total number of records. next_page: anyOf: - type: integer - type: 'null' title: '' description: The next page number, if one exists. type: object required: - data - current_page - total_records - next_page title: PaginatedResponse[EmailThreadSummary] HTTPValidationError: $defs: ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Type type: string required: - loc - msg - type title: ValidationError type: object x-speakeasy-include: true properties: type: const: request-validation title: Type type: string detail: anyOf: - type: string - type: 'null' default: null description: Human-readable description of this specific problem. title: Detail x-speakeasy-error-message: true status: const: 422 title: Status type: integer title: description: Short human-readable summary of the problem. title: Title type: string x-speakeasy-error-message: true errors: items: $ref: '#/components/schemas/ValidationError' title: Errors type: array required: - type - status - title - errors title: APIError type: object EmailThreadSummary: properties: created_at: type: string format: date-time title: '' modified_at: anyOf: - type: string format: date-time - type: 'null' title: '' id: type: string title: '' partner: anyOf: - $ref: '#/components/schemas/PartnerSummary' - type: 'null' title: '' triage: anyOf: - $ref: '#/components/schemas/TriageSummary' - type: 'null' title: '' has_attachments: type: boolean title: '' num_emails: type: integer title: '' num_drafts: type: integer title: '' first_email: anyOf: - $ref: '#/components/schemas/EmailSummary' - type: 'null' title: '' latest_email: anyOf: - $ref: '#/components/schemas/EmailSummary' - type: 'null' title: '' tasks: items: $ref: '#/components/schemas/TaskSummary' type: array title: '' description: Tasks explicitly linked to this email thread workflow: anyOf: - $ref: '#/components/schemas/OutreachWorkflowSummary' - type: 'null' title: '' latest_email_at: anyOf: - type: string format: date-time - type: 'null' title: '' last_inbound_at: anyOf: - type: string format: date-time - type: 'null' title: '' is_draft: type: boolean title: '' is_unread: type: boolean title: '' object: type: string title: '' description: >- String representing the object's type. Objects of the same type share the same value. readOnly: true type: object required: - created_at - modified_at - id - partner - triage - has_attachments - num_emails - num_drafts - first_email - latest_email - tasks - workflow - latest_email_at - last_inbound_at - is_draft - is_unread - object title: EmailThreadSummary description: Lightweight email thread summary for inbox list views. ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: type: string title: Type required: - loc - msg - type title: ValidationError type: object x-speakeasy-include: true PartnerSummary: properties: created_at: $ref: '#/components/schemas/UTCDateTime' title: '' modified_at: anyOf: - $ref: '#/components/schemas/UTCDateTime' - type: 'null' title: '' id: type: string title: '' account_number: anyOf: - type: string - type: 'null' title: '' description: The customer's account number. assignee_id: anyOf: - type: string - type: 'null' title: '' description: The ID of the user assigned to this partner, if any. business_unit_id: anyOf: - type: string - type: 'null' title: '' description: The business unit this partner belongs to. currency: anyOf: - $ref: '#/components/schemas/Currency' - type: 'null' title: '' description: The partner's default currency code (e.g. USD). email: anyOf: - type: string - type: 'null' title: '' description: The partner's company email address. name: anyOf: - type: string - type: 'null' title: '' description: The full name of the partner. legal_name: anyOf: - type: string - type: 'null' title: '' description: The legal name of this partner, typically applies to businesses. phone: anyOf: - type: string format: phone description: >- A phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format - type: 'null' title: '' description: The partner's default phone number. parent_id: anyOf: - type: string - type: 'null' title: '' remote_id: type: string title: '' description: The partner's third party id. object: type: string title: '' description: >- String representing the object's type. Objects of the same type share the same value. readOnly: true type: object required: - created_at - modified_at - id - account_number - assignee_id - business_unit_id - currency - email - name - legal_name - phone - parent_id - remote_id - object title: PartnerSummary TriageSummary: properties: created_at: $ref: '#/components/schemas/UTCDateTime' title: '' modified_at: anyOf: - $ref: '#/components/schemas/UTCDateTime' - type: 'null' title: '' status: $ref: '#/components/schemas/EmailThreadTriageStatus' title: '' description: 'Triage state: pending, auto_matched, manually_matched, dismissed.' is_loading: type: boolean title: '' description: >- Pending triage row not yet resolved (no match_source, no error); sorts last in the inbox list. suggested_partner: anyOf: - $ref: '#/components/schemas/PartnerSummary' - type: 'null' title: '' agent_confidence_score: anyOf: - type: integer - type: 'null' title: '' description: >- The confidence score of the result on a scale of 0-100, where 0 indicates no confidence in the accuracy of the result and 100 indicates full confidence in the accuracy of the result. match_source: anyOf: - type: string enum: - llm - manual - auto x-speakeasy-enum-format: union - type: 'null' title: '' description: 'How the partner was matched: ''llm'', ''manual'', or ''auto''' matched_at: anyOf: - $ref: '#/components/schemas/UTCDateTime' - type: 'null' title: '' description: When this triage thread was resolved (partner assigned or dismissed) matched_by_id: anyOf: - type: string - type: 'null' title: '' description: User who assigned the partner (NULL for auto-match) object: type: string title: '' description: >- String representing the object's type. Objects of the same type share the same value. readOnly: true type: object required: - created_at - modified_at - status - is_loading - suggested_partner - agent_confidence_score - match_source - matched_at - matched_by_id - object title: TriageSummary description: >- Lightweight triage state for inbox list rows; heavy fields stay on the v1 detail view. EmailSummary: properties: created_at: type: string format: date-time title: '' modified_at: anyOf: - type: string format: date-time - type: 'null' title: '' id: type: string title: '' subject: anyOf: - type: string - type: 'null' title: '' snippet: anyOf: - type: string - type: 'null' title: '' from: anyOf: - type: string - type: 'null' title: '' to: items: type: string type: array title: '' cc: items: type: string type: array title: '' description: List of CC email addresses direction: $ref: '#/components/schemas/RequestDirection' title: '' description: The request direction of the email. Either inbound or outbound status: $ref: '#/components/schemas/EmailStatus' title: '' sent_at: anyOf: - type: string format: date-time - type: 'null' title: '' description: When the email was sent. is_unread: type: boolean title: '' object: type: string title: '' description: >- String representing the object's type. Objects of the same type share the same value. readOnly: true type: object required: - created_at - modified_at - id - subject - snippet - from - to - cc - direction - status - sent_at - is_unread - object title: EmailSummary description: Email summary for inbox list rows. TaskSummary: properties: created_at: $ref: '#/components/schemas/UTCDateTime' title: '' modified_at: anyOf: - $ref: '#/components/schemas/UTCDateTime' - type: 'null' title: '' id: type: string title: '' type: $ref: '#/components/schemas/TaskType' title: '' description: The type of the task. status: $ref: '#/components/schemas/TaskStatus' title: '' description: The current status of the task. label: type: string title: '' description: The blurb or label for the task. description: anyOf: - type: string - type: 'null' title: '' description: The contextual description of the task. assignee_id: anyOf: - type: string - type: 'null' title: '' description: The ID of the user assigned to this task, if any. object: type: string title: '' description: >- String representing the object's type. Objects of the same type share the same value. readOnly: true type: object required: - created_at - modified_at - id - type - status - label - description - assignee_id - object title: TaskSummary description: Task summary for list views. OutreachWorkflowSummary: properties: created_at: $ref: '#/components/schemas/UTCDateTime' title: '' modified_at: anyOf: - $ref: '#/components/schemas/UTCDateTime' - type: 'null' title: '' id: type: string title: '' name: type: string title: '' description: The name of the workflow is_active: type: boolean title: '' object: type: string title: '' description: >- String representing the object's type. Objects of the same type share the same value. readOnly: true type: object required: - created_at - modified_at - id - name - is_active - object title: OutreachWorkflowSummary UTCDateTime: type: string format: date-time Currency: type: string enum: - ADP - AED - AFA - AFN - ALK - ALL - AMD - ANG - AOA - AOK - AON - AOR - ARA - ARL - ARM - ARP - ARS - ATS - AUD - AWG - AZM - AZN - BAD - BAM - BAN - BBD - BDT - BEC - BEF - BEL - BGL - BGM - BGN - BGO - BHD - BIF - BMD - BND - BOB - BOL - BOP - BOV - BRB - BRC - BRE - BRL - BRN - BRR - BRZ - BSD - BTN - BUK - BWP - BYB - BYN - BYR - BZD - CAD - CDF - CHE - CHF - CHW - CLE - CLF - CLP - CNH - CNX - CNY - COP - COU - CRC - CSD - CSK - CUC - CUP - CVE - CYP - CZK - DDM - DEM - DJF - DKK - DOP - DZD - ECS - ECV - EEK - EGP - ERN - ESA - ESB - ESP - ETB - EUR - FIM - FJD - FKP - FRF - GBP - GEK - GEL - GHC - GHS - GIP - GMD - GNF - GNS - GQE - GRD - GTQ - GWE - GWP - GYD - HKD - HNL - HRD - HRK - HTG - HUF - IDR - IEP - ILP - ILR - ILS - INR - IQD - IRR - ISJ - ISK - ITL - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRH - KRO - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LTL - LTT - LUC - LUF - LUL - LVL - LVR - LYD - MAD - MAF - MCF - MDC - MDL - MGA - MGF - MKD - MKN - MLF - MMK - MNT - MOP - MRO - MRU - MTL - MTP - MUR - MVP - MVR - MWK - MXN - MXP - MXV - MYR - MZE - MZM - MZN - NAD - NGN - NIC - NIO - NLG - NOK - NPR - NZD - OMR - PAB - PEI - PEN - PES - PGK - PHP - PKR - PLN - PLZ - PTE - PYG - QAR - RHD - ROL - RON - RSD - RUB - RUR - RWF - SAR - SBD - SCR - SDD - SDG - SDP - SEK - SGD - SHP - SIT - SKK - SLE - SLL - SOS - SRD - SRG - SSP - STD - STN - SUR - SVC - SYP - SZL - THB - TJR - TJS - TMM - TMT - TND - TOP - TPE - TRL - TRY - TTD - TWD - TZS - UAH - UAK - UGS - UGX - USD - USN - USS - UYI - UYP - UYU - UYW - UZS - VEB - VED - VEF - VES - VND - VNN - VUV - WST - XAF - XAG - XAU - XBA - XBB - XBC - XBD - XCD - XCG - XDR - XEU - XFO - XFU - XOF - XPD - XPF - XPT - XRE - XSU - XTS - XUA - XXX - YDD - YER - YUD - YUM - YUN - YUR - ZAL - ZAR - ZMK - ZMW - ZRN - ZRZ - ZWD - ZWL - ZWR description: >- The 3 character [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. x-speakeasy-enum-format: union RequestDirection: type: string enum: - inbound - outbound title: RequestDirection EmailStatus: type: string enum: - draft - pending - sending - sent - error title: EmailStatus TaskType: type: string enum: - auto_response_email - auto_response_sms - call_analysis - disable_contact - recommendation_new_contact - manual_call - broken_promise_follow_up - payment_promise - escalation - pause_state_update - dispute_create - dispute_activate - dispute_update - dispute_resolution title: TaskType TaskStatus: type: string enum: - open - completed - closed - archived - failed - processing - assigned_to_agent - research title: TaskStatus securitySchemes: HTTPBearer: type: http scheme: bearer ````