Get Execution Status
Check the status of an execution request
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 theallow_partial_results
flag totrue
in the API request to fetch result.
Headers
API Key for the service
Path Parameters
Execution ID
Query Parameters
Alternative to using the X-Dune-Api-Key header
Response
Timestamp of when the query execution was cancelled, if applicable.
Timestamp of when the query execution ended.
Unique identifier for the execution of the query and corresponding result.
Timestamp of when the query execution started.
Timestamp of when the query result expires.
Whether the state of the query execution is terminal. This can be used for polling purposes.
Number of interactive executions this customer can have running in parallel
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
Unique identifier of the query.
Metadata about the execution of the query, including details like column names, row counts, and execution times.
The state of the query execution.
Timestamp of when the query was submitted.
Was this page helpful?