Get Batch Job Info

curl --request GET \
  --url https://api.bigdata.com/v1/search/batches/{batch_id} \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.bigdata.com/v1/search/batches/{batch_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bigdata.com/v1/search/batches/{batch_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bigdata.com/v1/search/batches/{batch_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/search/batches/{batch_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "batch_id": "<string>",
  "status": "pending",
  "output_file_url": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

Batch Search

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.

GET

batches

{batch_id}

Get Batch Job Info

curl --request GET \
  --url https://api.bigdata.com/v1/search/batches/{batch_id} \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.bigdata.com/v1/search/batches/{batch_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bigdata.com/v1/search/batches/{batch_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bigdata.com/v1/search/batches/{batch_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/search/batches/{batch_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "batch_id": "<string>",
  "status": "pending",
  "output_file_url": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

Authorizations

X-API-KEY

string

header

required

Path Parameters

batch_id

string

required

Response

batch_id

string

required

The unique identifier for your batch job.

status

enum<string>

required

Current processing state of your batch job. Poll this endpoint until status reaches completed or failed.

Available options:

pending,

processing,

completed,

failed,

cancelled

output_file_url

string<uri> | null

Signed URL on batch-search.bigdata.com to download your results, in the form https://batch-search.bigdata.com/results/<batch_id>/results.jsonl?Expires=...&Signature=...&Key-Pair-Id=.... Available only when status is completed. Use a simple GET request to download the .jsonl results file. The link is valid for one hour; call this endpoint again to get a new one. Use the URL exactly as returned, because the query parameters carry the signature.

API

Knowledge Graph

Search Service

Watchlists

Monitors

Research Service

Content

Structured Data

Subscription

SDK

Get Batch Job Info

Authorizations

Path Parameters

Response