Method: jobs.get

Returns information about a specific job. Job information is available for a six month period after creation. Requires that you're the person who ran the job, or have the Is Owner project role.

HTTP request

GET https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/jobs/{jobId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. Project ID of the requested job.

jobId

string

Required. Job ID of the requested job.

Query parameters

Parameters
___location

string

The geographic ___location of the job. You must specify the ___location to run the job for the following scenarios:

  • If the ___location to run a job is not in the us or the eu multi-regional ___location
  • If the job's ___location is in a single region (for example, us-central1)

For more information, see how to specify locations.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Job.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/bigquery.readonly
  • https://www.googleapis.com/auth/cloud-platform.read-only

For more information, see the Authentication Overview.