> ## Documentation Index > Fetch the complete documentation index at: https://docs.leadvector.app/api-reference/llms.txt > Use this file to discover all available pages before exploring further. # Get inbox items > Returns inbox items belonging to the authenticated API user. ## OpenAPI ````yaml /openapi.json get /v1/inbox openapi: 3.1.0 info: title: LeadVector API version: '1' description: >- Find and verify business emails and mobile numbers, enrich people and companies, and run your email campaigns, mailboxes and inbox. Send your API key in the `x-api-key` header. servers: - url: https://prod.leadvector.app description: Production security: - access-key: [] tags: - name: Authentication description: Check that an API key works. - name: Lookups description: >- Find business emails and mobile numbers, verify emails, and find the person behind an email. - name: Enrichment description: The full profile of a person or a company. - name: Campaigns description: Email campaigns and their sequences. - name: Leads description: A campaign's leads. - name: Email accounts description: The mailboxes campaigns send from, and their warmup. - name: Inbox description: Replies to your campaigns, in one inbox. - name: Webhooks description: Subscribe URLs to events, and read the events sent. - name: Campaign events description: >- A campaign's lifecycle: created, launched, paused, resumed, stopped, completed, deleted. - name: Lead events description: A lead joining a campaign, replying, being labelled, finishing or failing. - name: Email events description: Each step's email to a lead, sent or failed. - name: Inbox events description: Mail the inbox receives, and the replies and forwards sent from it. - name: Email account events description: A mailbox's connection, pause, cooldown, warmup health and deletion. - name: Lookup events description: >- A single lookup’s result, in the app, the extension or the API: an email or a mobile found, an email verified, a person or a company enriched. - name: Bulk job events description: A bulk job (a file of lookups) completing or failing. - name: List events description: A contact saved to one of the team’s lists. - name: Credit events description: The team’s credits running low, or out. - name: Test event description: The event an endpoint gets when you send it a test. paths: /v1/inbox: get: tags: - Inbox summary: Get inbox items description: Returns inbox items belonging to the authenticated API user. operationId: ApiV1InboxController_findAll parameters: - name: tab required: false in: query schema: type: string enum: - primary - others example: primary - name: mailbox required: false in: query schema: example: inbox type: string enum: - inbox - unread - reminders - scheduled - sent - archived - name: mailboxId required: false in: query schema: type: number example: 1 - name: status required: false in: query schema: example: Lead type: string enum: - Lead - Interested - Out of office - Not interested - name: search required: false in: query schema: example: john type: string - name: read required: false in: query schema: type: boolean example: false - name: archived required: false in: query schema: type: boolean example: false - name: campaignUuid required: false in: query description: Only conversations that belong to this campaign schema: format: uuid example: 019e8eb2-a04a-76a8-8aed-37178d5786f5 type: string - name: campaignsOnly required: false in: query description: Only conversations that belong to any campaign schema: type: boolean example: true responses: '200': description: Inbox items fetched successfully content: application/json: schema: $ref: '#/components/schemas/InboxListResponseDto' '400': description: Invalid filter. content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '401': description: API_KEY_REQUIRED / INVALID_API_KEY content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '403': description: ACCOUNT_DEACTIVATED / TEAM_DEACTIVATED content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '429': description: RATE_LIMIT_EXCEEDED, with a Retry-After header content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponseDto' security: - access-key: [] components: schemas: InboxListResponseDto: type: object properties: success: type: boolean example: true message: type: string example: Inbox items fetched successfully data: $ref: '#/components/schemas/InboxListDataDto' required: - success - message - data ApiErrorResponseDto: type: object properties: statusCode: type: number example: 401 message: description: >- A code in capitals; the list of messages when the body fails validation; `Internal server error` for a 500. oneOf: - type: string - type: array items: type: string example: INVALID_API_KEY error: type: string description: The status's name. example: Unauthorized traceId: type: string description: Quote it when you contact support. example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f timestamp: type: string example: '2026-11-03T09:41:12.000Z' path: type: string example: /v1/find-email required: - statusCode - message - traceId - timestamp - path RateLimitErrorResponseDto: type: object properties: statusCode: type: number example: 401 message: description: The error's code. oneOf: - type: string - type: array items: type: string example: RATE_LIMIT_EXCEEDED error: type: string description: The status's name. example: Unauthorized traceId: type: string description: Quote it when you contact support. example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f timestamp: type: string example: '2026-11-03T09:41:12.000Z' path: type: string example: /v1/find-email limit: type: number description: Calls allowed per window. example: 10 windowSeconds: type: number example: 60 retryAfterSeconds: type: number description: Seconds until the next call is allowed. example: 6 required: - statusCode - message - traceId - timestamp - path - limit - windowSeconds - retryAfterSeconds InboxListDataDto: type: object properties: data: type: array items: $ref: '#/components/schemas/UniboxResponseDto' total: type: number description: 'Items in `data`: the list is not paged.' example: 25 meta: type: object description: Counts for the inbox tabs and filters. additionalProperties: true required: - data - total - meta UniboxResponseDto: type: object properties: id: type: string example: '1' mailboxId: type: number example: 12 description: >- The mailbox that owns this message, so clients can reply from its identity. avatar: type: string example: P fromEmail: type: string example: pbryant@dotcommerce.email toEmail: example: john@johntheplumber.com description: Null for an outbound message whose recipient is not on record. type: - string - 'null' subject: type: string example: Closing the loop on John The Plumber preview: type: string example: Closing the loop on John The Plumber body: type: string example: |- Hi John, Following up... date: type: string example: Monday, Apr 27, 2026 dateShort: type: string example: Apr 27 year: type: string example: '2026' time: type: string example: 7:18 pm status: type: string example: Lead replyCount: type: number example: 5 aiDetected: type: boolean example: true tab: type: string example: primary mailbox: type: string example: inbox read: type: boolean example: false archived: type: boolean example: false scheduled: type: boolean example: false reminderAt: example: '2026-06-20T10:00:00.000Z' type: - string - 'null' required: - id - mailboxId - avatar - fromEmail - toEmail - subject - preview - body - date - dateShort - year - time - status - replyCount - tab - mailbox - read - archived - scheduled securitySchemes: access-key: type: apiKey in: header name: x-api-key description: Your API key, from the API keys page of the app. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.