Check the status of your batch job and retrieve results when processing is complete.
batch_id: Your job’s unique identifierstatus: Current processing state (pending, processing, completed, failed, or cancelled)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) |
OK
The unique identifier for your batch job.
Current processing state of your batch job. Poll this endpoint until status reaches completed or failed.
pending, processing, completed, failed, cancelled Presigned URL to download your results. Available only when status is completed. Use a simple GET request to download the .jsonl results file.