---
title: "GET /v1/jobs/{jobId}"
method: GET
path: "/v1/jobs/{jobId}"
tags: ["jobs"]
---

# GET /v1/jobs/{jobId}

`GET /v1/jobs/{jobId}`

## Request

- Base URL: `https://youtubereporting.googleapis.com`
- URL: `https://youtubereporting.googleapis.com/v1/jobs/{jobId}`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/yt-analytics.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/yt-analytics.readonly`

Gets a job.

## Path parameters

- `jobId` string, required

## Query parameters

- `onBehalfOfContentOwner` string

## Response `200`

Successful response

- Job: A job creating reports of a specific type.
  - `createTime` string, google-datetime: The creation date/time of the job.
  - `expireTime` string, google-datetime: The date/time when this job will expire/expired. After a job expired, no new reports are generated.
  - `id` string: The server-generated ID of the job (max. 40 characters).
  - `name` string: The name of the job (max. 100 characters).
  - `reportTypeId` string: The type of reports this job creates. Corresponds to the ID of a ReportType.
  - `systemManaged` boolean: True if this a system-managed job that cannot be modified by the user; otherwise false.

## Changes

- **2026-10-10** `12713aee36ed`: 1 breaking, 4 info
  - removed the media type `*/*` for the response with the status `200`
  - the security scope `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/yt-analytics.readonly` was removed from the endpoint's security scheme `Oauth2`
  - …1 more
- **2026-10-10** `8605a14dfdd9`: 4 info
  - the security scope `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/yt-analytics.readonly` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/yt-analytics.readonly` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/youtubereporting/changes/v1/jobs/:jobId/get.md)

---

[API](https://skmtc.dev/google/apis/youtubereporting.md) - [All operations](https://skmtc.dev/google/apis/youtubereporting/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/youtubereporting/revisions/88074b6984ff?raw)
