latestOpenAPI 3.1.0Proprietary2026-08-175035117.5 KB

019f79ecdd6c

SQL

List jobs

Lists the asynchronous jobs in your account.

Only userId, createdSince and client are accepted — any other query parameter returns 400.

get/v3/sql/jobs

Query parameters

user_idstring

Filter by user. Ignored when authenticating with an API Access Token, which is always scoped to its own user.

created_sincestring date-time

Only return jobs created after this date.

Response

The jobs.

externalIdstring
accountIdstring
userIdstring nullable
connectionIdstring
metadataobject
createdAtstring date-time
updatedAtstring date-time
querystring nullable
state'pending' | 'running' | 'success' | 'failure' | 'cancelled' | 'blocked' | 'resuming_warehouse'

success, failure and cancelled are final states.

jobMetadataobject
tokenstring nullable