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

# Find email (synchronous)

> Synchronous. Finds one person's work email and returns the result in the same response, no job and no polling.

Consumes credits only on a hit: your account's email price when a value is found. A miss is free, and a value your account obtained in the last 30 days, through the API or the app, is returned free. not_found can be temporary; a later retry may find a value and is free if it misses again.

Input: personID (from POST /search), or person fields: linkedinURL, or firstName + lastName + a company signal (companyDomain preferred over company name). personID cannot be combined with person fields; a valid linkedinURL takes precedence over name and company. Optional externalID (max 128 chars) is echoed back.

status is succeeded or not_found. A personID that matches no person returns not_found at no cost. A call can take tens of seconds; set your client timeout accordingly.



## OpenAPI

````yaml https://api.leadsforge.ai/public/swagger/doc.json post /enrichment/email
openapi: 3.1.0
info:
  description: >-
    Search B2B leads, find their work emails, phone numbers and LinkedIn
    profiles, and discover lookalike companies, company page followers and local
    businesses.


    Authenticate every request with your API key in the `Authorization` header:
    the raw key, no `Bearer` prefix. Create the key in the Leadsforge app under
    Settings -> API & MCP.


    Paid operations consume credits from your account balance, and each
    operation says whether it is paid. Long-running operations are asynchronous:
    they return a job that you poll (or receive by webhook) and then page
    through its results.


    Errors return a JSON body with a human-readable `message` and, except for an
    unknown path (404), a stable `code`. Program against `code`. A JSON body
    with a field the operation does not accept is rejected with 400 bad_request,
    listing the unknown fields in data.validations. A request still running when
    the server timeout is reached is cut off with 503 and an empty body.
  license:
    name: Proprietary
    url: https://www.leadsforge.ai/terms
  termsOfService: https://www.leadsforge.ai/terms
  title: Leadsforge API
  version: '1.0'
servers:
  - url: https://api.leadsforge.ai/public/v1
security: []
tags:
  - description: Your account's credit balance.
    name: Balance
  - description: >-
      Find people by role, seniority, company, location and other filters.
      Searches and counts are free up to a monthly allowance, then each one
      costs credits; finding contact details is charged separately.
    name: Search
  - description: >-
      Accepted values for the controlled filters of POST /search and POST
      /search/count, and a resolver for location strings. All free.
    name: Search filters
  - description: >-
      Find work emails, phone numbers and LinkedIn profiles. Asynchronous jobs
      take up to 500 people; synchronous calls take one person and answer in the
      same response.
    name: Enrichment
  - description: >-
      Find companies similar to the domains you give. Previews are free up to a
      monthly allowance, then each one costs credits; the search consumes
      credits per company returned.
    name: Lookalikes
  - description: >-
      Find the people who follow a LinkedIn company page. Asynchronous jobs that
      consume credits per follower collected.
    name: Company followers
  - description: >-
      Find local businesses in an area you choose, then find their owners'
      emails and phone numbers. Both steps are asynchronous jobs that consume
      credits.
    name: Maps discovery
  - description: Scrape LinkedIn Sales Navigator searches.
    name: salesnav
externalDocs:
  description: Leadsforge API guides
  url: >-
    https://developer.salesforge.ai/leadsforge-api/concepts/search-and-enrichment
paths:
  /enrichment/email:
    post:
      tags:
        - Enrichment
      summary: Find email (synchronous)
      description: >-
        Synchronous. Finds one person's work email and returns the result in the
        same response, no job and no polling.


        Consumes credits only on a hit: your account's email price when a value
        is found. A miss is free, and a value your account obtained in the last
        30 days, through the API or the app, is returned free. not_found can be
        temporary; a later retry may find a value and is free if it misses
        again.


        Input: personID (from POST /search), or person fields: linkedinURL, or
        firstName + lastName + a company signal (companyDomain preferred over
        company name). personID cannot be combined with person fields; a valid
        linkedinURL takes precedence over name and company. Optional externalID
        (max 128 chars) is echoed back.


        status is succeeded or not_found. A personID that matches no person
        returns not_found at no cost. A call can take tens of seconds; set your
        client timeout accordingly.
      operationId: enrichEmail
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyncEnrichmentRequest'
              description: Person to enrich
              summary: body
        description: Person to enrich
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SyncEnrichmentResponse'
          description: Enrichment result
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: 'bad_request: the body or a parameter is invalid'
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            missing_api_key, invalid_api_key, or unauthorized when your account
            is blocked
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            insufficient_credits: the balance does not cover the credits this
            request reserves
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            account_frozen: credit spending is paused for your account; contact
            support
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            rate_limited: too many requests, retry later; Retry-After is set
            when known
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: 'internal: unexpected server error'
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            service_unavailable: synchronous lookup is not available for this
            channel; use the asynchronous job
      security:
        - ApiKeyAuth: []
components:
  schemas:
    SyncEnrichmentRequest:
      properties:
        company:
          example: Salesforge
          type: string
        companyDomain:
          example: salesforge.ai
          type: string
        externalID:
          example: crm-contact-42
          maxLength: 128
          type: string
        firstName:
          example: John
          type: string
        lastName:
          example: Doe
          type: string
        linkedinURL:
          example: https://www.linkedin.com/in/example-profile
          type: string
        personID:
          type: string
      type: object
    SyncEnrichmentResponse:
      properties:
        channel:
          enum:
            - email
            - phone
          type: string
        email:
          type: string
        externalID:
          type: string
        personID:
          type: string
        phoneNumber:
          type: string
        status:
          enum:
            - succeeded
            - not_found
          type: string
      type: object
    ApiError:
      properties:
        code:
          description: >-
            Code is the stable, machine-readable error code; each endpoint lists
            the codes it returns.
          type: string
        data:
          description: >-
            Data carries details for some errors; on validation errors it is
            {"validations": ["..."]}, one message per

            invalid field.
        message:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: >-
        Your API key, sent as is (no `Bearer` prefix). Create it in the
        Leadsforge app under Settings -> API & MCP.
      in: header
      name: Authorization
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.