v1

latestOpenAPI 3.0.12026-07-22367385.5 KB

Check the status of an execution request

get/v1/execution/{execution_id}/status

Path parameters

execution_idstring required

Execution ID

Query parameters

api_keystring

Alternative to using the X-Dune-Api-Key header

Headers

X-Dune-Api-Keystring required

API Key for the service

Response

cancelled_atstring

Timestamp of when the query execution was cancelled, if applicable.

execution_cost_creditsnumber

Cost of the execution

execution_ended_atstring

Timestamp of when the query execution ended.

execution_idstring

Unique identifier for the execution of the query and corresponding result.

execution_started_atstring

Timestamp of when the query execution started.

expires_atstring

Timestamp of when the query result expires.

is_execution_finishedboolean

Whether the state of the query execution is terminal. This can be used for polling purposes.

max_inflight_interactive_executionsinteger

Number of interactive executions this customer can have running in parallel

max_inflight_interactive_reachedinteger

Total number of interactive executions this user has submitted which are still in progress only set to > 0 if the user has reached the limit of concurrent interactive executions

query_idinteger

Unique identifier of the query.

queue_positioninteger

statestring

The state of the query execution.

submitted_atstring

Timestamp of when the query was submitted.

Example response

{
  "cancelled_at": "2024-12-20T11:04:18.724658237Z",
  "error": {
    "message": "Error: Line 1:1: mismatched input 'selecdt'",
    "metadata": {
      "column": 73,
      "line": 10
    },
    "type": "syntax_error"
  },
  "execution_ended_at": "2024-12-20T11:04:18.724658237Z",
  "execution_id": "01HKZJ2683PHF9Q9PHHQ8FW4Q1",
  "execution_started_at": "2024-12-20T11:04:18.724658237Z",
  "expires_at": "2024-12-20T11:04:18.724658237Z",
  "is_execution_finished": true,
  "max_inflight_interactive_executions": 3,
  "max_inflight_interactive_reached": 5,
  "query_id": 1234,
  "queue_position": 1,
  "result_metadata": {
    "column_names": [
      "Rank",
      "Project",
      "Volume"
    ],
    "column_types": [
      "double",
      "varchar",
      "bigint"
    ],
    "datapoint_count": 1000,
    "execution_time_millis": 1000,
    "pending_time_millis": 1000,
    "result_set_bytes": 1000,
    "row_count": 10,
    "total_result_set_bytes": 10000,
    "total_row_count": 1000
  },
  "state": "QUERY_STATE_COMPLETED",
  "submitted_at": "2024-12-20T11:04:18.724658237Z"
}