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

# GET /v1/jobs/{jobId}/reports

`GET /v1/jobs/{jobId}/reports`

## Request

- Base URL: `https://youtubereporting.googleapis.com`
- URL: `https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports`
- 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`

Lists reports created by a specific job. Returns NOT_FOUND if the job does not exist.

## Path parameters

- `jobId` string, required

## Query parameters

- `createdAfter` string, google-datetime
- `onBehalfOfContentOwner` string
- `pageSize` integer
- `pageToken` string
- `startTimeAtOrAfter` string, google-datetime
- `startTimeBefore` string, google-datetime

## Response `200`

Successful response

- ListReportsResponse: Response message for ReportingService.ListReports.
  - `nextPageToken` string: A token to retrieve next page of results. Pass this value in the ListReportsRequest.page_token field in the subsequent call to `ListReports` method to retrieve the next page of results.
  - `reports` Report[]: The list of report types.
    - `createTime` string, google-datetime: The date/time when this report was created.
    - `downloadUrl` string: The URL from which the report can be downloaded (max. 1000 characters).
    - `endTime` string, google-datetime: The end of the time period that the report instance covers. The value is exclusive.
    - `id` string: The server-generated ID of the report.
    - `jobExpireTime` string, google-datetime: The date/time when the job this report belongs to will expire/expired.
    - `jobId` string: The ID of the job that created this report.
    - `startTime` string, google-datetime: The start of the time period that the report instance covers. The value is inclusive.

## 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/reports/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)
