> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octavehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolve Email from Profile

> Resolve the best work email for a person from their LinkedIn profile (or name + company) using Octave's enrichment data, with a deliverability status. The reverse of resolveProfile. Supports a confidence threshold and an optional thorough effort mode. Charges credits only when a deliverable email is found at or above the requested confidence.



## OpenAPI

````yaml post /api/v2/person/resolve-email
openapi: 3.0.0
info:
  version: 1.0.0
  title: Octave API
  description: API for Octave workspace management and AI-powered content generation
servers:
  - url: https://app.octavehq.com
security:
  - ApiKeyAuth: []
paths:
  /api/v2/person/resolve-email:
    post:
      tags:
        - Research
      summary: Resolve Email from Profile
      description: >-
        Resolve the best work email for a person from their LinkedIn profile (or
        name + company) using Octave's enrichment data, with a deliverability
        status. The reverse of resolveProfile. Supports a confidence threshold
        and an optional thorough effort mode. Charges credits only when a
        deliverable email is found at or above the requested confidence.
      operationId: resolveEmail
      requestBody:
        description: Identifiers to resolve an email from
        content:
          application/json:
            schema:
              type: object
              properties:
                linkedInProfile:
                  type: string
                  nullable: true
                  description: >-
                    LinkedIn profile URL or slug. The strongest identifier for
                    resolving an email.
                  example: https://www.linkedin.com/in/jane-doe
                firstName:
                  type: string
                  nullable: true
                  description: First name (used with company when no LinkedIn)
                lastName:
                  type: string
                  nullable: true
                  description: Last name (used with company when no LinkedIn)
                companyName:
                  type: string
                  nullable: true
                  description: Company name (used with name when no LinkedIn)
                companyDomain:
                  type: string
                  nullable: true
                  description: Company domain (used with name when no LinkedIn)
                minConfidence:
                  type: string
                  enum:
                    - LOW
                    - MEDIUM
                    - HIGH
                  default: LOW
                  description: >-
                    Minimum confidence required for the email to count as found.
                    Lower-confidence emails are returned as found=false (no
                    credits charged).
                effort:
                  type: string
                  enum:
                    - standard
                    - thorough
                  default: standard
                  description: >-
                    `standard` resolves the profile via the strongest identifier
                    only; `thorough` also tries the alternate resolution path.
      responses:
        '200':
          description: Resolution result (found may be false)
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/Metadata'
                  found:
                    type: boolean
                    description: Whether an email met the confidence threshold
                  email:
                    type: string
                    nullable: true
                    example: jane@acme.com
                  emailStatus:
                    type: string
                    nullable: true
                    enum:
                      - valid
                      - invalid
                      - accept_all
                      - webmail
                      - catchall
                      - disposable
                      - unknown
                      - not_found
                      - null
                    description: Deliverability status from the email provider
                  confidence:
                    type: string
                    nullable: true
                    enum:
                      - LOW
                      - MEDIUM
                      - HIGH
                      - null
                  meetsConfidenceThreshold:
                    type: boolean
                  effort:
                    type: string
                    enum:
                      - standard
                      - thorough
                  creditsCharged:
                    type: number
                    description: Credits charged for this call (0 if not found)
                  matchedProfile:
                    type: object
                    nullable: true
                    properties:
                      firstName:
                        type: string
                        nullable: true
                        example: Jane
                      lastName:
                        type: string
                        nullable: true
                        example: Doe
                      fullName:
                        type: string
                        nullable: true
                        example: Jane Doe
                      title:
                        type: string
                        nullable: true
                        example: VP of Engineering
                      headline:
                        type: string
                        nullable: true
                        description: LinkedIn headline
                      seniority:
                        type: string
                        nullable: true
                        description: Normalized current seniority
                      jobFunction:
                        type: string
                        nullable: true
                        description: Normalized current job function
                      linkedInUrl:
                        type: string
                        nullable: true
                        example: https://www.linkedin.com/in/jane-doe
                      linkedInSlug:
                        type: string
                        nullable: true
                        example: jane-doe
                      companyName:
                        type: string
                        nullable: true
                        example: Acme
                      companyDomain:
                        type: string
                        nullable: true
                        example: acme.com
                      companyLinkedInUrl:
                        type: string
                        nullable: true
                      location:
                        type: string
                        nullable: true
                        example: San Francisco, CA
                      city:
                        type: string
                        nullable: true
                        example: San Francisco
                      countryCode:
                        type: string
                        nullable: true
                        example: US
                      summary:
                        type: string
                        nullable: true
                      photoUrl:
                        type: string
                        nullable: true
                    description: The profile the email was resolved for
                  message:
                    type: string
                    nullable: true
                required:
                  - _metadata
                  - found
                  - meetsConfidenceThreshold
                  - effort
                  - creditsCharged
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/Metadata'
                  message:
                    type: string
                required:
                  - _metadata
                  - message
      deprecated: false
components:
  schemas:
    Metadata:
      type: object
      properties:
        usage:
          type: number
          default: 0
          example: 0
          description: API usage
        requestId:
          type: string
          example: requestId
          description: Request ID
        message:
          type: string
          example: message
          description: Message
        timestamp:
          type: string
          example: '2021-01-01T00:00:00.000Z'
          description: Timestamp
      required:
        - requestId
        - timestamp
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key

````