Get Task Status Function

API Doc

Interactive API docs can be found at: https://run.truebit.network/dispatcher/api-docs/

Overview

By calling this endpoint, you’ll receive the Function Task execution status and, if available, the result associated with the specified executionId

Get execution status by execution ID of a FUNCTION TASK

get

https://run.truebit.network

/task/function/execution-status/{executionId}

Retrieve the status of a task execution using the execution ID.

Path parameters

executionIdstringRequired

The ID of the task execution.

Responses

200

Successful function task response with execution status.

application/json

Synchronous response of task execution.

executionIdstringOptional

The ID of the task execution.

verificationStatusstring · enumOptional

The status of the task verification.

Possible values:

404

Execution ID not found

application/json

500

Internal server error.

application/json

get

/task/function/execution-status/{executionId}

HTTPcURLJavaScriptPython

GET /task/function/execution-status/{executionId} HTTP/1.1
Host: run.truebit.network
Accept: */*

{
  "executionId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeee",
  "clearTextSolution": {
    "output": "function task output",
    "executionStatus": "succeed",
    "senderAddress": "0x************************************79C8"
  },
  "signature": {
    "v": 28,
    "r": "20476805d11b************************************83f93de9b185d486",
    "s": "07f38e3b3633************************************236081b5b8f74e66"
  },
  "verificationStatus": "Success"
}

verificationStatus

Success	The Task execution was completed successfully. The result was received within the specified timeout, and all nodes provided the same response.
Running	The Function task is still being executed.
Indeterminate	A consensus on the result couldn't be reached. This could be because the execution took too long, nodes gave different answers (requiring an adjudication process resolution), or we received fewer responses than the required solutions defined in the request.
Error	There was an error during the task execution