Skip to main content
GET
/
tasks
/
{taskId}
Get Task Status
curl --request GET \
  --url https://api.curalabs.io/v1/tasks/{taskId} \
  --header 'X-API-Key: <api-key>'
{
  "task_id": "tsk_abc123xyz789",
  "status": "processing",
  "result": {
    "summary": "Search performed, first result obtained.",
    "data": {
      "first_link": "https://example-ai-site.com"
    }
  },
  "error": "Extension connection lost during execution.",
  "created_at": "2025-04-13T23:00:00Z",
  "updated_at": "2025-04-13T23:01:00Z"
}

Authorizations

​
X-API-Key
string
header
required

API Key provided by the platform. Note- X-Timestamp and X-Signature headers are also required for authentication, but not defined as separate schemes here due to OpenAPI limitations on complex signature schemes.

Path Parameters

​
taskId
string
required

The ID of the task to retrieve.

Example:

"tsk_abc123xyz789"

Response

OK. Current status and details of the task.

​
task_id
string

The unique identifier for the task.

Example:

"tsk_abc123xyz789"

​
status
enum<string>

The current status of the task.

Available options:
queued,
processing,
completed,
failed
Example:

"processing"

​
result
object | null

The result object if the task completed successfully. Structure may vary.

Example:
{
  "summary": "Search performed, first result obtained.",
  "data": {
    "first_link": "https://example-ai-site.com"
  }
}
​
error
string | null

Error message if the task failed.

Example:

"Extension connection lost during execution."

​
created_at
string<date-time>

ISO 8601 timestamp when the task was created.

Example:

"2025-04-13T23:00:00Z"

​
updated_at
string<date-time>

ISO 8601 timestamp when the task was last updated.

Example:

"2025-04-13T23:01:00Z"

⌘I