- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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
|
Required. Project ID of the requested job. |
jobId
|
Required. Job ID of the requested job. |
Query 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
usor theeumulti-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 .

