Browse API docsGet task IDs in a batch
External API docs

Get task IDs in a batch

After a batch is ready, fetch task IDs for completed tasks so you can retrieve final task results.

Endpoint

Route
GET https://api.openmart.ai/api/v1/task/batch/:batch_id/task_ids?status=COMPLETED

Use this endpoint after batch_ready is true. Replace <batch_id> with your batch ID.

Authentication. We recommend sending your API key as Authorization: Bearer <your_api_key>. If your current integration already uses X-API-Key: <your_api_key>, it will continue to work.

Parameters

Parameter
batch_id
Type
string
Required
Yes
Example
"183219bc..."
Description
The batch ID returned when you submit a batch request.
Parameter
status
Type
string
Required
No
Example
"COMPLETED"
Description
Optional status filter for returned task IDs (for example COMPLETED).

cURL request

cURL
curl --request GET \
  --url https://api.openmart.ai/api/v1/task/batch/<batch_id>/task_ids?status=COMPLETED \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <your_api_key>'

Response example

JSON
[
  "2fc8b627-1111-2222-3333-123456789abc"
]

If this request fails

Match the error number or message in the response, then use the action below.

Error 400 / 422“... is required” or another field error
Read the error or detail field, then fix the named input.
Error 401“Invalid API Key”
Check the complete key and authentication header.
Error 402“Credit limit reached”
Check the team balance before trying again.
Error 403“Forbidden” or “not allowed”
Check whether this key and account can use the action.
Error 404“Not Found”
Check the API address, version, and GET, POST, or DELETE method.
Error 429“Too many requests”
Wait, then retry with fewer requests running at once.
Error 500–504Server error or timeout
Wait briefly and retry. Avoid duplicating an async job.

See Troubleshooting & FAQ for step-by-step help and the information to include when asking for support.