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

# Get Batch Job Info

> Check the status of your batch job and retrieve results when processing is complete.

- `batch_id`: Your job's unique identifier
-  `status`: Current processing state (pending, processing, completed, failed, or cancelled)
- `estimated_completion_time`: A dynamic ISO 8601 timestamp indicating when the job is expected to finish. This adjusts in real-time based on system throughput and queue backlog.
- `output_file_url`: Download link for your results (available when status is completed)

Once your batch reaches `completed` status, use the `output_file_url` to download a `.jsonl` file containing all results via a simple GET request.

Each line in your results file contains:

| Field | Type | Description |
|-------|------|-------------|
| line_number | int | Matches the line number from your original input file |
| status | string | Result status: success, error, timeout, or exception |
| query | object | The original search query you submitted |
| response | object | The Search response for this query |
| code | int | HTTP status code |
| error | string | Error description (only present if request failed) |

For a step-by-step walkthrough, see the [Batch Search how-to guide](/how-to-guides/search/batch_search).



## OpenAPI

````yaml /api-rest/openapi/openapi_search_service.json get /v1/search/batches/{batch_id}
openapi: 3.0.3
info:
  title: Bigdata Search API
  version: 1.0.0
  description: >-
    Easily find the most relevant information from trusted sources and your own
    data. Use it to power agents that give accurate, real-time answers.
servers:
  - url: https://api.bigdata.com/
security:
  - ApiKeyAuth: []
paths:
  /v1/search/batches/{batch_id}:
    get:
      tags:
        - Batch Search
      summary: Get Batch Job Info
      description: >-
        Check the status of your batch job and retrieve results when processing
        is complete.


        - `batch_id`: Your job's unique identifier

        -  `status`: Current processing state (pending, processing, completed,
        failed, or cancelled)

        - `estimated_completion_time`: A dynamic ISO 8601 timestamp indicating
        when the job is expected to finish. This adjusts in real-time based on
        system throughput and queue backlog.

        - `output_file_url`: Download link for your results (available when
        status is completed)


        Once your batch reaches `completed` status, use the `output_file_url` to
        download a `.jsonl` file containing all results via a simple GET
        request.


        Each line in your results file contains:


        | Field | Type | Description |

        |-------|------|-------------|

        | line_number | int | Matches the line number from your original input
        file |

        | status | string | Result status: success, error, timeout, or exception
        |

        | query | object | The original search query you submitted |

        | response | object | The Search response for this query |

        | code | int | HTTP status code |

        | error | string | Error description (only present if request failed) |


        For a step-by-step walkthrough, see the [Batch Search how-to
        guide](/how-to-guides/search/batch_search).
      operationId: get_batch_job_info_v1_search_batches__batch_id__get
      parameters:
        - name: batch_id
          in: path
          required: true
          schema:
            type: string
            title: Batch Id
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchJobStatusResponse'
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    BatchJobStatusResponse:
      properties:
        batch_id:
          type: string
          title: Batchid
          description: The unique identifier for your batch job.
        status:
          allOf:
            - $ref: '#/components/schemas/Status'
          description: >-
            Current processing state of your batch job. Poll this endpoint until
            status reaches `completed` or `failed`.
        output_file_url:
          type: string
          format: uri
          nullable: true
          title: Output File Url
          description: >-
            Presigned URL to download your results. Available only when status
            is `completed`. Use a simple GET request to download the `.jsonl`
            results file.
      type: object
      required:
        - batch_id
        - status
      title: BatchJobStatusResponse
    ErrorResponse:
      properties:
        statusCode:
          type: integer
          title: Statuscode
        message:
          type: string
          title: Message
      type: object
      required:
        - statusCode
        - message
      title: ErrorResponse
    Status:
      type: string
      enum:
        - pending
        - processing
        - completed
        - failed
        - cancelled
      title: Status
      description: Public-facing batch job status values.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````