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

# Get Enrichment Job Status

> Get the comprehensive status of an enrichment job.

Provides detailed information about job progress, timing, resource usage,
and results. Includes error information for failed jobs and progress
estimates for running jobs.

Args:
    job_id: The job ID to check (must be valid UUID format)
    current_user: Authenticated user
    supabase_service: Supabase service instance for job tracking

Returns:
    EnrichmentJobStatus with comprehensive job information

Raises:
    HTTPException: If job not found, access denied, or system error



## OpenAPI

````yaml https://api.bavlio.com/openapi.json get /api/v1/enrichment/job/{job_id}/status
openapi: 3.1.0
info:
  title: Bavlio API
  description: >-
    Outreach automation API — lead enrichment, email campaigns, LinkedIn
    automation, and AI agent. Full docs at https://docs.bavlio.com.
  version: 1.0.0
servers: []
security: []
tags:
  - name: API Keys
    description: >-
      Create, list, and revoke API keys for programmatic access. JWT
      authentication required.
  - name: credits
    description: Credit balance, cost estimates, and transaction history.
  - name: campaigns
    description: Create, manage, launch, and monitor email campaigns.
  - name: campaign-personalization
    description: AI-powered email subject and body personalization for campaigns.
  - name: email-finder
    description: Find and verify email addresses for prospects.
  - name: email-verification
    description: Validate email addresses and prune invalid entries from datasets.
  - name: sender-profiles
    description: Manage sender identity profiles for outreach.
  - name: sender-profile-chat
    description: Interactive chat for building sender profiles.
  - name: templates
    description: Email template CRUD.
  - name: suppression
    description: Do-not-contact suppression list management.
  - name: datasets
    description: Lead dataset listing, download, and updates.
  - name: user-extractions
    description: Uploaded lead file management and processing.
  - name: enrichment-chat
    description: Interactive chat for data enrichment sessions.
  - name: enrichment-processing
    description: Batch lead enrichment processing.
  - name: File Upload (CSV/Excel)
    description: Upload and preview CSV/Excel lead files.
  - name: connected-accounts
    description: LinkedIn account connections via Unipile.
  - name: linkedin-content
    description: LinkedIn post creation, scheduling, and management.
  - name: linkedin-playground
    description: Direct LinkedIn actions (profile lookup, messaging, engagement).
  - name: bavimail-proxy
    description: BaviMail domain, alias, and email management.
  - name: agent
    description: Bavi AI agent chat with SSE streaming.
  - name: notifications
    description: Notification preferences and delivery.
  - name: referral
    description: Referral code management and stats.
  - name: feedback
    description: User feedback submission.
  - name: authentication
    description: JWT token verification and user info.
  - name: Google OAuth
    description: Google OAuth login flow and access tokens.
  - name: Google Sheets OAuth
    description: Google Sheets import and access management.
  - name: stripe
    description: Stripe checkout, billing portal, and subscription status. JWT only.
  - name: users
    description: User quota and usage information.
  - name: Health
    description: Health checks and system status.
  - name: Personalization
    description: Core lead personalization engine.
  - name: Session Management
    description: Enrichment session lifecycle.
  - name: Session Processing
    description: Session data processing.
  - name: webhooks
    description: Inbound webhook handlers (Stripe, BaviMail, Unipile).
paths:
  /api/v1/enrichment/job/{job_id}/status:
    get:
      tags:
        - enrichment-processing
      summary: Get Enrichment Job Status
      description: >-
        Get the comprehensive status of an enrichment job.


        Provides detailed information about job progress, timing, resource
        usage,

        and results. Includes error information for failed jobs and progress

        estimates for running jobs.


        Args:
            job_id: The job ID to check (must be valid UUID format)
            current_user: Authenticated user
            supabase_service: Supabase service instance for job tracking

        Returns:
            EnrichmentJobStatus with comprehensive job information

        Raises:
            HTTPException: If job not found, access denied, or system error
      operationId: get_enrichment_job_status_api_v1_enrichment_job__job_id__status_get
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnrichmentJobStatus'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    EnrichmentJobStatus:
      properties:
        job_id:
          type: string
          title: Job Id
          description: Job identifier
        status:
          type: string
          pattern: ^(queued|started|processing|finished|failed|cancelled)$
          title: Status
          description: Current job status
        progress:
          type: integer
          maximum: 100
          minimum: 0
          title: Progress
          description: Progress percentage (0-100)
        total:
          type: integer
          minimum: 0
          title: Total
          description: Total items to process
        processed:
          type: integer
          minimum: 0
          title: Processed
          description: Successfully processed items
        failed:
          type: integer
          minimum: 0
          title: Failed
          description: Failed items
        started_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Started At
          description: Job start timestamp
        completed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Completed At
          description: Job completion timestamp
        estimated_remaining_minutes:
          anyOf:
            - type: integer
            - type: 'null'
          title: Estimated Remaining Minutes
          description: Estimated time remaining in minutes
        credits_used:
          anyOf:
            - type: integer
            - type: 'null'
          title: Credits Used
          description: Credits consumed so far
        result:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Result
          description: Job result data if completed
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
          description: Error message if failed
      type: object
      required:
        - job_id
        - status
        - progress
        - total
        - processed
        - failed
      title: EnrichmentJobStatus
      description: Response model for enrichment job status.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````