> ## Documentation Index > Fetch the complete documentation index at: https://developer.firstsales.io/llms.txt > Use this file to discover all available pages before exploring further. # PublicApiListInboxThreads > GET /api/v1/organizations/{orgId}/workspaces/{wsId}/inbox/threads Use this endpoint through the Developer API or the matching `firstsales` CLI command when available. Responses use the stable FirstSales public error envelope. ## OpenAPI ````yaml GET /api/v1/organizations/{orgId}/workspaces/{wsId}/inbox/threads openapi: 3.1.0 info: title: FirstSales Developer API version: 1.0.0 description: >- Public v1 developer API for FirstSales.io. Generated from live step definitions — do not hand-edit. servers: - url: https://sandbox.api.app.firstsales.io - url: https://api.app.firstsales.io security: - bearerAuth: [] tags: - name: Activities - name: Alerts - name: API Keys - name: Authentication - name: Billing - name: Blocked Domains - name: Campaigns - name: Companies - name: Connectors - name: Contacts - name: Copilot - name: Dashboard - name: Deals - name: Direct Email - name: Email Authentication - name: Inbox - name: Knowledge Bases - name: Learning - name: Offerings - name: Organizations - name: Product Updates - name: Sequence Library - name: Signals description: >- Beta. Find people who comment on or react to LinkedIn posts by a keyword, a person or a company page. Each scan costs 10x the scraper cost in credits (1 credit = $0.01), capped by the daily budget of the signal. A scan that adds no new person is free. - name: Suppression - name: Team - name: Tracking Domains - name: Warmup paths: /api/v1/organizations/{orgId}/workspaces/{wsId}/inbox/threads: get: tags: - Inbox summary: PublicApiListInboxThreads operationId: listInboxThreads parameters: - name: orgId in: path required: true schema: type: string - name: wsId in: path required: true schema: type: string - name: tab in: query required: false schema: type: string enum: - all - needs-approval - unread - needs-reply - replies - completed - active - bounced - failed - warmup default: all - name: senderConnectorId in: query required: false schema: type: string minLength: 1 - name: campaignId in: query required: false schema: type: string minLength: 1 - name: category in: query required: false schema: type: string enum: - outreaching - marketing - warmup - name: from in: query required: false schema: type: string minLength: 1 maxLength: 64 - name: to in: query required: false schema: type: string minLength: 1 maxLength: 64 - name: sort in: query required: false schema: type: string enum: - newest - oldest default: newest - name: page in: query required: false schema: type: integer minimum: 1 maximum: 10000 default: 1 - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 50 default: 20 responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/PublicInboxThreadListResponse' '400': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '401': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '403': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '404': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '429': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '500': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '503': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' security: - developerKeyBearer: [] components: schemas: PublicInboxThreadListResponse: type: object properties: threads: type: array items: type: object properties: threadId: type: string minLength: 1 maxLength: 1024 subject: type: string lastMessageAt: type: string lastMessageDirection: type: string enum: - outbound - inbound messageCount: type: integer minimum: 0 maximum: 9007199254740991 unreadCount: type: integer minimum: 0 maximum: 9007199254740991 pendingApprovalCount: type: integer minimum: 0 maximum: 9007199254740991 hasBounce: type: boolean hasGoalHit: type: boolean hasFailed: type: boolean hasReply: type: boolean hasUnsubscribe: type: boolean hasOoo: type: boolean status: type: string journeyStatus: type: string contact: type: object properties: id: type: string email: type: string name: type: string required: - id - email additionalProperties: false campaign: type: object properties: id: type: string name: type: string goal: type: string required: - id - name - goal additionalProperties: false senderConnector: type: object properties: id: type: string email: type: string required: - id additionalProperties: false visibility: type: string ownerId: type: string ownerName: type: string assigneeId: type: string assigneeName: type: string isOrphan: type: boolean isWarmup: type: boolean dealId: type: string required: - threadId - subject - lastMessageAt - lastMessageDirection - messageCount - unreadCount - pendingApprovalCount - hasBounce - hasGoalHit - hasFailed - hasReply - hasUnsubscribe - hasOoo - status - journeyStatus - contact - campaign additionalProperties: false total: type: integer minimum: 0 maximum: 9007199254740991 page: type: integer minimum: 1 maximum: 9007199254740991 limit: type: integer minimum: 1 maximum: 50 tabCounts: type: object properties: all: type: integer minimum: 0 maximum: 9007199254740991 needs-approval: type: integer minimum: 0 maximum: 9007199254740991 unread: type: integer minimum: 0 maximum: 9007199254740991 replies: type: integer minimum: 0 maximum: 9007199254740991 completed: type: integer minimum: 0 maximum: 9007199254740991 active: type: integer minimum: 0 maximum: 9007199254740991 bounced: type: integer minimum: 0 maximum: 9007199254740991 failed: type: integer minimum: 0 maximum: 9007199254740991 warmup: type: integer minimum: 0 maximum: 9007199254740991 snoozed: type: integer minimum: 0 maximum: 9007199254740991 required: - all - needs-approval - unread - replies - completed - active - bounced - failed - warmup - snoozed additionalProperties: false required: - threads - total - page - limit - tabCounts additionalProperties: false PublicErrorEnvelope: type: object properties: error: type: object properties: code: type: string message: type: string requestId: type: string details: type: object additionalProperties: true required: - code - message - requestId required: - error securitySchemes: bearerAuth: type: http scheme: bearer description: Legacy compatibility bearer scheme for generated consumers. developerKeyBearer: type: http scheme: bearer description: FirstSales developer API key bearer token (fs-key-*). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.