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 usesgRPC 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 theus or theeu multi-regional location
  • If the job's location is in a single region (for example,us-central1)

For more information, see how tospecify locations.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance ofJob.

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 theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-02 UTC.