GET
/
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}}


{
  "execution_id": "01HJ3EBNGZ8WT12KX8ZCARM5ES",
  "query_id": 3298913,
  "state": "QUERY_STATE_COMPLETED",
  "is_execution_finished": true,
  "submitted_at": "2024-12-20T11:04:18.71989Z",
  "expires_at": "2025-03-19T11:04:19.423372Z",
  "execution_started_at": "2024-12-20T11:04:18.724658237Z",
  "execution_ended_at": "2024-12-20T11:04:19.423371588Z",
  "result_metadata": {
    "column_names": [
      "Rank",
      "project",
      "Total Volume",
      "7 Days Volume",
      "24 Hours Volume"
    ],
    "datapoint_count": 40,
    "execution_time_millis": 18272,
    "pending_time_millis": 16,
    "result_set_bytes": 440,
    "total_row_count": 8
  }
}

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.


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

unique identifier of the execution

Query Parameters

​
api_key
string

API Key for the service, alternative to using the HTTP header X-DUNE-API-KEY.

Response

200
application/json

OK

The response is of type object.

GET
/
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}}


{
  "execution_id": "01HJ3EBNGZ8WT12KX8ZCARM5ES",
  "query_id": 3298913,
  "state": "QUERY_STATE_COMPLETED",
  "is_execution_finished": true,
  "submitted_at": "2024-12-20T11:04:18.71989Z",
  "expires_at": "2025-03-19T11:04:19.423372Z",
  "execution_started_at": "2024-12-20T11:04:18.724658237Z",
  "execution_ended_at": "2024-12-20T11:04:19.423371588Z",
  "result_metadata": {
    "column_names": [
      "Rank",
      "project",
      "Total Volume",
      "7 Days Volume",
      "24 Hours Volume"
    ],
    "datapoint_count": 40,
    "execution_time_millis": 18272,
    "pending_time_millis": 16,
    "result_set_bytes": 440,
    "total_row_count": 8
  }
}

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.


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

unique identifier of the execution

Query Parameters

​
api_key
string

API Key for the service, alternative to using the HTTP header X-DUNE-API-KEY.

Response

200
application/json

OK

The response is of type object.