> ## 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 email account details

> Returns a single email account belonging to the authenticated API user.



## OpenAPI

````yaml /openapi.json get /v1/email-accounts/{mailboxId}
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/email-accounts/{mailboxId}:
    get:
      tags:
        - Email accounts
      summary: Get email account details
      description: Returns a single email account belonging to the authenticated API user.
      operationId: ApiV1EmailAccountsController_getAccount
      parameters:
        - name: mailboxId
          required: true
          in: path
          description: Mailbox identifier
          schema:
            type: number
            example: 1
      responses:
        '200':
          description: Email account fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailAccountResponseDto'
        '400':
          description: The id is not a number.
          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'
        '404':
          description: Mailbox not found / Email account not found
          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:
    EmailAccountResponseDto:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Email account fetched successfully
        data:
          $ref: '#/components/schemas/EmailAccountDto'
      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
    EmailAccountDto:
      type: object
      properties:
        id:
          type: number
          description: The id the routes below take.
          example: 12
        uuid:
          type: string
          example: 019f2504-58b8-77ec-9c3f-54f5d6df7350
        email:
          type: string
          example: sam@northwind.example
        displayName:
          example: Sam Roe
          type:
            - string
            - 'null'
        provider:
          type: string
          enum:
            - GOOGLE_WORKSPACE
            - MICROSOFT_365
            - ZOHO
            - YAHOO
            - PROTONMAIL
            - MAILGUN
            - GODADDY
            - FASTMAIL
            - AMAZON_SES
            - PROOFPOINT
            - MIMECAST
            - CISCO
            - BARRACUDA
            - SOPHOS
            - TREND_MICRO
            - UNKNOWN
            - OTHER
          example: GOOGLE_WORKSPACE
        status:
          type: string
          enum:
            - ACTIVE
            - PAUSED
            - COOLDOWN
            - BLOCKED
            - DISCONNECTED
          example: ACTIVE
        health:
          type: string
          enum:
            - HEALTHY
            - WARNING
            - RISKY
            - BAD
          example: HEALTHY
        lastConnectedAt:
          format: date-time
          type:
            - string
            - 'null'
        lastUsedAt:
          format: date-time
          type:
            - string
            - 'null'
        cooldownUntil:
          description: While warmup health has paused it.
          format: date-time
          type:
            - string
            - 'null'
        lastErrorReason:
          example: null
          type:
            - string
            - 'null'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        domain:
          anyOf:
            - $ref: '#/components/schemas/EmailAccountDomainDto'
            - type: 'null'
        warmupProfile:
          anyOf:
            - $ref: '#/components/schemas/WarmupProfileDto'
            - type: 'null'
      required:
        - id
        - uuid
        - email
        - provider
        - status
        - health
        - lastConnectedAt
        - lastUsedAt
        - cooldownUntil
        - lastErrorReason
        - createdAt
        - updatedAt
        - domain
        - warmupProfile
    EmailAccountDomainDto:
      type: object
      properties:
        id:
          type: number
          example: 7
        name:
          type: string
          example: northwind.example
        isWarmupEnabled:
          type: boolean
          example: true
        status:
          type: boolean
          example: true
      required:
        - id
        - name
        - isWarmupEnabled
        - status
    WarmupProfileDto:
      type: object
      properties:
        status:
          type: string
          example: ACTIVE
        warmupDay:
          type: number
          description: Days the warmup has run.
          example: 12
        dailyLimit:
          type: number
          example: 20
        hourlyLimit:
          type: number
          example: 5
        minuteLimit:
          type: number
          example: 1
        maxDailyLimit:
          type: number
          example: 40
        increasePerDay:
          type: number
          example: 2
        disableSlowWarmup:
          type: boolean
          example: false
        replyRatePercent:
          type: number
          example: 30
        weekdaysOnly:
          type: boolean
          example: true
        dailyCampaignLimit:
          example: 50
          description: Campaign emails a day at most; null when unset.
          type:
            - number
            - 'null'
        replyToAddress:
          example: null
          type:
            - string
            - 'null'
        usedToday:
          type: number
          example: 14
        emailsSentCount:
          type: number
          example: 320
        emailsReceivedCount:
          type: number
          example: 290
        bounceCount:
          type: number
          example: 0
        warmupScore:
          type: number
          description: From 0 to 100.
          example: 92
        lastWarmupAt:
          format: date-time
          type:
            - string
            - 'null'
        nextWarmupAt:
          format: date-time
          type:
            - string
            - 'null'
        lastErrorReason:
          example: null
          type:
            - string
            - 'null'
      required:
        - status
        - warmupDay
        - dailyLimit
        - hourlyLimit
        - minuteLimit
        - maxDailyLimit
        - increasePerDay
        - disableSlowWarmup
        - replyRatePercent
        - weekdaysOnly
        - dailyCampaignLimit
        - replyToAddress
        - usedToday
        - emailsSentCount
        - emailsReceivedCount
        - bounceCount
        - warmupScore
        - lastWarmupAt
        - nextWarmupAt
        - lastErrorReason
  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.