latestOpenAPI 3.1.0Proprietary2026-08-175035117.5 KB

019f79ecdd6c

SQL

Get a job

Returns the current state of an asynchronous job.

get/v3/sql/{connectionName}/job/{jobId}

Path parameters

connectionNamestring required

Name of the connection to use.

jobIdstring required

The job identifier.

Response

The job.

jobIdstring
connectionNamestring
providerIdstring
querystring nullable
status'pending' | 'running' | 'success' | 'failure' | 'cancelled' | 'blocked' | 'resuming_warehouse'

success, failure and cancelled are final states.

createdAtstring date-time
providerobject

Provider-specific execution detail. Omitted for jobs created from a named source.

jobMetadataobject
metadataobject
tokenstring nullable