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

# Get vector database ingestion job status

> Retrieve the status of a specific vector database ingestion job.

Retrieve the full details of a vector database ingestion job, including its status, output files, and `file_records` array. Each file record includes the file's processing state, timestamps for each state transition, queue position, and error diagnostics when failures occur.

Once completed, source tracing metadata (line numbers, character offsets, heading hierarchy, and source page number) is available for every indexed chunk via the chunk endpoint.

For job states, error codes, and SDK examples, see [Monitor ingestion](/flow/sdk/data-engine/monitor-ingestion).


## OpenAPI

````yaml get /v1/flow/vectordb/{database_id}/ingestion/{job_id}
openapi: 3.1.0
info:
  title: SeekrFlow API
  description: SeekrFlow API Documentation
  termsOfService: http://www.seekr.com/support
  contact:
    name: Seekr API Support
    url: http://www.seekr.com/contact
    email: contact@seekr.com
  version: 5.99.0
servers:
  - url: https://flow.seekr.com
    description: SeekrBuild server base URL
security: []
paths:
  /v1/flow/vectordb/{database_id}/ingestion/{job_id}:
    get:
      tags:
        - Vector database
      summary: Get vector database ingestion job status
      description: Retrieve the status of a specific vector database ingestion job.
      operationId: >-
        get_vector_database_ingestion_job_v1_flow_vectordb__database_id__ingestion__job_id__get
      parameters:
        - name: database_id
          in: path
          required: true
          schema:
            type: string
            title: Database Id
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            title: Job Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorDatabaseIngestionResponse'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    VectorDatabaseIngestionResponse:
      properties:
        id:
          type: string
          title: Id
        vector_database_id:
          type: string
          title: Vector Database Id
        status:
          type: string
          title: Status
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
        file_ids:
          items:
            type: string
          type: array
          title: File Ids
        metaflow_run_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Metaflow Run Id
        file_records:
          anyOf:
            - items:
                $ref: '#/components/schemas/VectorDatabaseFileResponse'
              type: array
            - type: 'null'
          title: File Records
      type: object
      required:
        - id
        - vector_database_id
        - status
        - created_at
        - updated_at
        - error_message
        - file_ids
        - metaflow_run_id
      title: VectorDatabaseIngestionResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    VectorDatabaseFileResponse:
      properties:
        id:
          type: string
          title: Id
        record_id:
          type: string
          title: Record Id
        vector_database_id:
          type: string
          title: Vector Database Id
        filename:
          type: string
          title: Filename
        method:
          anyOf:
            - type: string
            - type: 'null'
          title: Method
        chunk_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Chunk Method
        token_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Token Count
        overlap_tokens:
          anyOf:
            - type: integer
            - type: 'null'
          title: Overlap Tokens
        created_at:
          type: string
          format: date-time
          title: Created At
        ingestion_job_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Ingestion Job Id
        status:
          type: string
          title: Status
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
        suggested_fix:
          anyOf:
            - type: string
            - type: 'null'
          title: Suggested Fix
        processing_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Processing At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        failed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Failed At
        file_size_in_bytes:
          anyOf:
            - type: integer
            - type: 'null'
          title: File Size In Bytes
        queue_position:
          anyOf:
            - type: integer
            - type: 'null'
          title: Queue Position
          description: Position in queue if status is queued
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
          description: >-
            User-defined metadata associated with this file's chunks. Set at
            ingestion time or updated via PATCH
            /vectordb/{database_id}/metadata.
      type: object
      required:
        - id
        - record_id
        - vector_database_id
        - filename
        - created_at
        - status
      title: VectorDatabaseFileResponse
      description: Response model for a vector database file
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: >-
        Your Seekr API key, sent in the Authorization header with no 'Bearer'
        prefix.
      in: header
      name: Authorization

````