> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # List inbox threads > List inbox threads grouped by contact. Required parameters: - None Optional query parameters: - page: 1-based page number. Defaults to 1. - pageSize: number of threads per page. Defaults to 25. - search: free-text search across contact name, company name, email, and recent message content. - senderIdentityId: scope the inbox to a single sender identity when the same contact appears in multiple sender mailboxes - tagId: return only threads tagged with this inbox tag ID. Look up tag IDs via GET /v1/inbox/tags - archived: set to true to return archived threads instead of active ones. Defaults to false. > **Required scope:** `MESSAGING_READ` > > **Rate limit:** 100 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/inboxes openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/inboxes: get: tags: - Inbox summary: List inbox threads description: >- List inbox threads grouped by contact. Required parameters: - None Optional query parameters: - page: 1-based page number. Defaults to 1. - pageSize: number of threads per page. Defaults to 25. - search: free-text search across contact name, company name, email, and recent message content. - senderIdentityId: scope the inbox to a single sender identity when the same contact appears in multiple sender mailboxes - tagId: return only threads tagged with this inbox tag ID. Look up tag IDs via GET /v1/inbox/tags - archived: set to true to return archived threads instead of active ones. Defaults to false. > **Required scope:** `MESSAGING_READ` > > **Rate limit:** 100 requests per minute parameters: - schema: type: integer exclusiveMinimum: 0 description: 1-based page number. Defaults to 1. example: 1 required: false description: 1-based page number. Defaults to 1. name: page in: query - schema: type: integer exclusiveMinimum: 0 maximum: 100 description: Number of threads per page. Defaults to 25. Maximum is 100. example: 25 required: false description: Number of threads per page. Defaults to 25. Maximum is 100. name: pageSize in: query - schema: type: string description: >- Free-text search across contact name, company name, email, and recent message content. example: pricing northstar required: false description: >- Free-text search across contact name, company name, email, and recent message content. name: search in: query - schema: type: integer exclusiveMinimum: 0 description: >- Scope the inbox to one sender identity when the same contact appears in multiple sender mailboxes. example: 14 required: false description: >- Scope the inbox to one sender identity when the same contact appears in multiple sender mailboxes. name: senderIdentityId in: query - schema: type: integer exclusiveMinimum: 0 description: >- Return only threads tagged with this inbox tag ID. Look up tag IDs via GET /v1/inbox/tags. example: 13014 required: false description: >- Return only threads tagged with this inbox tag ID. Look up tag IDs via GET /v1/inbox/tags. name: tagId in: query - schema: type: boolean description: Return archived threads instead of active ones. Defaults to false. example: false required: false description: Return archived threads instead of active ones. Defaults to false. name: archived in: query responses: '200': description: Successful response with paginated inbox threads content: application/json: schema: type: object properties: data: type: array items: type: object properties: contactId: type: number description: Contact ID for the inbox thread latestConversationId: type: number description: Latest visible conversation ID for the contact firstName: type: - string - 'null' description: Contact first name lastName: type: - string - 'null' description: Contact last name fullName: type: string description: Contact full name email: type: - string - 'null' description: Professional email for the contact companyId: type: - number - 'null' description: Company ID associated with the contact companyName: type: - string - 'null' description: Company name associated with the contact companyDomain: type: - string - 'null' description: Company domain associated with the contact senderIdentityIds: type: array items: type: number description: >- Sender identities that currently have visible conversations channels: type: array items: type: string enum: - EMAIL - LINKEDIN description: >- Channels that appear across the visible conversations for this contact unreadMessagesCount: type: number description: >- Unread inbound message count across the visible conversations lastActivityAt: type: string format: date-time description: Timestamp of the latest visible inbox activity summary: type: string description: Summary of the latest visible message tags: type: array items: type: object properties: id: type: number description: Tag identifier name: type: string description: Tag name color: type: string description: Tag color required: - id - name - color description: Distinct tags visible on the contact thread required: - contactId - latestConversationId - firstName - lastName - fullName - email - companyId - companyName - companyDomain - senderIdentityIds - channels - unreadMessagesCount - lastActivityAt - summary - tags meta: type: object properties: page: type: number pageSize: type: number total: type: number required: - page - pageSize - total required: - data - meta examples: default: summary: One inbox thread with unread activity value: data: - contactId: 123 latestConversationId: 456 firstName: Alicia lastName: Stone fullName: Alicia Stone email: alicia@northstar.io companyId: 77 companyName: Northstar companyDomain: northstar.io senderIdentityIds: - 14 channels: - EMAIL unreadMessagesCount: 2 lastActivityAt: '2026-03-20T09:41:12.000Z' summary: Thanks, this looks interesting. Can you send pricing? tags: - id: 5 name: Hot lead color: '#F97316' meta: page: 1 pageSize: 25 total: 1 '404': description: Sender identity or inbox tag not found security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````