External API docs

Get task results

Fetch the final payload for an async 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 payload for a single task (for example a people enrichment or tech detection task) once it reaches COMPLETED.

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 'X-API-Key: <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 }
    }
  ]
}
# Get Task Results

## Endpoint

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

## Description

Fetch the final payload for an individual async task after the batch has produced task IDs.

## Authentication

Header: `X-API-Key: <your_api_key>`

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| task_id | string (path) | Yes | The task ID returned for an individual task inside a batch. |

## Example Request

```bash
curl -X GET "https://api.openmart.ai/api/v1/task/<task_id>" \
  -H "Accept: application/json" \
  -H "X-API-Key: <your_api_key>"
```

## Example Response

```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 }
    }
  ]
}
```

Statuses: PROCESSING, COMPLETED, ERRORED, or CANCELLED.