> ## 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.

# Get enrichment job

> Free. Synchronous. Returns the status and counters of an enrichment job: status is in_progress, then completed, or failed when it could not finish (a job in which every person failed still ends completed). processed counts the people handled so far, succeeded those with a value found, and failed every person without a value, so people whose value was simply not found count as failed too; the status of each result tells not_found from failed. When a job fails, people it had not reached count as processed and failed but get no result and no webhook, so the results list has fewer entries than total. consumedCredits is set when the job finishes and is absent while it is 0; reservedCredits stays at the amount held at start. Poll it until the status is final, then read GET /enrichment/jobs/{jobID}/results. Requires the job ID returned when the job was created.



## OpenAPI

````yaml https://api.leadsforge.ai/public/swagger/doc.json get /enrichment/jobs/{jobID}
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/jobs/{jobID}:
    get:
      tags:
        - Enrichment
      summary: Get enrichment job
      description: >-
        Free. Synchronous. Returns the status and counters of an enrichment job:
        status is in_progress, then completed, or failed when it could not
        finish (a job in which every person failed still ends completed).
        processed counts the people handled so far, succeeded those with a value
        found, and failed every person without a value, so people whose value
        was simply not found count as failed too; the status of each result
        tells not_found from failed. When a job fails, people it had not reached
        count as processed and failed but get no result and no webhook, so the
        results list has fewer entries than total. consumedCredits is set when
        the job finishes and is absent while it is 0; reservedCredits stays at
        the amount held at start. Poll it until the status is final, then read
        GET /enrichment/jobs/{jobID}/results. Requires the job ID returned when
        the job was created.
      operationId: getEnrichmentJob
      parameters:
        - description: Job ID
          in: path
          name: jobID
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnrichmentJobResponse'
          description: Job status
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            missing_api_key, invalid_api_key, or unauthorized when your account
            is blocked
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: 'not_found: no job with this ID in your account'
        '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'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    EnrichmentJobResponse:
      properties:
        channel:
          enum:
            - email
            - phone
            - linkedin
          type: string
        clientRequestID:
          type: string
        completedAt:
          type: string
        consumedCredits:
          type: number
        createdAt:
          type: string
        failed:
          type: integer
        jobID:
          type: string
        processed:
          type: integer
        reservedCredits:
          type: number
        resultsURL:
          description: >-
            ResultsURL is the path of this job's results on the API host, e.g.
            /public/v1/enrichment/jobs/{jobID}/results.
          type: string
        status:
          enum:
            - in_progress
            - completed
            - failed
          type: string
        statusURL:
          description: >-
            StatusURL is the path of this job on the API host, e.g.
            /public/v1/enrichment/jobs/{jobID}.
          type: string
        succeeded:
          type: integer
        total:
          type: integer
        updatedAt:
          type: string
        webhookURL:
          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.