---
title: "Returns the report information"
method: GET
path: "/api/v3/advertisers/{advertiserId}/reports/{reportId}"
tags: ["Reporting"]
---

# Returns the report information

`GET /api/v3/advertisers/{advertiserId}/reports/{reportId}`

## Request

- Base URL: `https://ads.nextdoor.com`
- URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/reports/{reportId}`
- Auth: HTTP bearer

## Path parameters

- `advertiserId` string, required
- `reportId` string, required

## Response `200`

The report with the id specified in the URL

- object
  - `advertiser_id` string: The id of the advertiser profile.
  - `dimensions` string[], nullable: The dimensions configured for the report.
  - `download_url` string: The download URL of the report.
  - `filters` object[], nullable: List of filters for the reports, e.g. Campaign ID contains 1234, e.g. Campaign ID contains 1234.
    - `attribute` 'AD' | 'AD_GROUP' | 'CAMPAIGN' | 'PLACEMENT': Report attribute to filter by.
    - `operator` 'CONTAINS': Filter operator
    - `options` string[]: User selected values to filter on.
  - `id` string: The id of the report
  - `metrics` string[], nullable: The report metrics.
  - `name` string: The name of the report.
  - `output_format` 'CSV' | 'XLSX': Output format of the generated report (e.g. CSV or XLSX).
  - `status` 'STARTED' | 'IN_PROGRESS' | 'CANCELING' | 'CANCELED' | 'COMPLETED' | 'FAILED' | 'ARCHIVED' | 'UNKNOWN': The status of the report.

## Other responses

- `400`: Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input.
- `401`: Unauthorized. The API key is invalid and needs to be re-generated.
- `403`: Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions.
- `500`: Internal server error.
- `503`: The server is temporarily unable to handle the request due to maintenance or overload.

---

[API](https://skmtc.dev/nextdoor/apis/advertising.md) - [All operations](https://skmtc.dev/nextdoor/apis/advertising/llms.txt) - [OpenAPI document](https://skmtc.dev/nextdoor/apis/advertising/revisions/cdbbecabcffc?raw)