GET
https://api.dune.com/api
/
v1
/
execution
/
{execution_id}
/
status

curl -X GET "https://api.dune.com/api/v1/execution/{{execution_id}}/status" -H x-dune-api-key:{{api_key}}


{
  "cancelled_at": "2024-12-20T11:04:18.724658237Z",
  "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"
}

You must pass the execution_id obtained from making an execute query POST request.

Returns the status of a query execution along with relevant metadata of the results if the execution is completed.

​
Execution States

Once an execution is triggered, it can be in one of the following states:

  • QUERY_STATE_PENDING: The query execution is waiting for an execution slot.
  • QUERY_STATE_EXECUTING: The query is currently executing.
  • QUERY_STATE_FAILED: The query execution failed. This is a terminal state.
  • QUERY_STATE_COMPLETED: The query execution completed successfully. You can retrieve the query result for this execution_id.
  • QUERY_STATE_CANCELED: The query execution was canceled by the user.
  • QUERY_STATE_EXPIRED: The query execution expired, and the result is no longer available.
  • QUERY_STATE_COMPLETED_PARTIAL: The query execution was successful, but the result was truncated because it was too large. To receive the truncated result, set the allow_partial_results flag to true in the API request to fetch result.

curl -X GET "https://api.dune.com/api/v1/execution/{{execution_id}}/status" -H x-dune-api-key:{{api_key}}

Headers

​
X-Dune-Api-Key
string
required

API Key for the service

Path Parameters

​
execution_id
string
required

Execution ID

Query Parameters

​
api_key
string

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

Response

200
application/json

OK

The response is of type object.