GET
/
v1
/
execution
/
{execution_id}
/
status

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.

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
execution_id
string
required

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

query_id
integer
required

Unique identifier of the query.

state
string
required

The state of the query execution.

submitted_at
string
required

Timestamp of when the query was submitted.

is_execution_finished
boolean

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

expires_at
string

Timestamp of when the query result expires.

execution_started_at
string

Timestamp of when the query execution started.

execution_ended_at
string

Timestamp of when the query execution ended.

cancelled_at
string

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

result_metadata
object

Metadata about the execution of the query, including details like column names, row counts, and execution times.