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.

​
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_CANCELLED: The query execution was cancelled 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.

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
cancelled_at
string

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

execution_ended_at
string

Timestamp of when the query execution ended.

execution_id
string

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

execution_started_at
string

Timestamp of when the query execution started.

expires_at
string

Timestamp of when the query result expires.

is_execution_finished
boolean

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

query_id
integer

Unique identifier of the query.

queue_position
integer
result_metadata
object

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

state
string

The state of the query execution.

submitted_at
string

Timestamp of when the query was submitted.

Was this page helpful?

Cancel ExecutionGet Execution Result