Browse API docsGet task results
External API docs

Get task results

Retrieve the final result for a background enrichment task after the batch has produced task IDs.

Endpoint

Route
GET https://api.openmart.ai/api/v1/task/:task_id

Use this endpoint to retrieve the final result for a single task (for example a people enrichment or tech detection task) once it reaches COMPLETED.

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
task_id
Type
string
Required
Yes
Example
"2fc8b627..."
Description
The task ID returned for an individual task inside a batch once the batch is ready.

cURL request

cURL
curl --request GET \
  --url https://api.openmart.ai/api/v1/task/<task_id> \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <your_api_key>'

Response example

JSON
{
  "task_id": "2fc8b627-1111-2222-3333-123456789abc",
  "status": "COMPLETED",
  "tracking_id": "customer-42",
  "data": [
    {
      "first_name": "Jane",
      "last_name": "Doe",
      "title": "Head of Marketing",
      "email": { "email": "jane@bluebottlecoffee.com", "verified": true }
    }
  ]
}

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.