---
title: "Get a report"
method: GET
path: "/reports/{report_id}"
tags: ["Reports and Statements"]
---

# Get a report

`GET /reports/{report_id}`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/reports/{report_id}`
- Auth: OAuth 2
  - Authorization code: `https://api.whatnot.com/seller-api/rest/oauth/authorize`
  - Token URL: `https://api.whatnot.com/seller-api/rest/oauth/token`

Retrieve one of the seller's report generation runs. Requires read:reports.

## Path parameters

- `report_id` string, uuid, required: The report run's ID.

## Response `200`

Successful Response

- Report: One asynchronous report generation run. Runs are created `pending`; generation happens asynchronously.
  - `id` string, uuid, required: The report run's ID.
  - `report_type` 'seller_financial_report' | 'analytics_overview_report' | 'analytics_livestreams_report', required
  - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required
  - `report_parameters` union, required: The parameters this run covers, after defaults were applied. The shape depends on `report_type`. Null when the run has no parameters.
    - FinancialReportParameters: Parameters for a `seller_financial_report` run.
      - `report_type` 'seller_financial_report', required: The type of report these parameters describe.
      - `start_date` string, date-time, nullable: Include only transactions completed at or after this time. Defaults to one week before `end_date`.
      - `end_date` string, date-time, nullable: Include only transactions completed before this time. Defaults to one week after `start_date`, or to the current hour when neither end is given.
    - AnalyticsOverviewReportParameters: Parameters for an `analytics_overview_report` run. The report is one row per calendar day of the window.
      - `report_type` 'analytics_overview_report', required: The type of report these parameters describe.
      - `start_at` string, date-time, required: The start of the reported window.
      - `end_at` string, date-time, required: The end of the reported window. Must be after `start_at`.
    - LivestreamsReportParameters: Parameters for an `analytics_livestreams_report` run. Exactly one of `all_matching` and `specific_shows` selects the shows.
      - `report_type` 'analytics_livestreams_report', required: The type of report these parameters describe.
      - `all_matching` MatchingShowsFilter: Which of the seller's shows an `all_matching` report covers.
        - `title` string, nullable: Include only shows whose title matches this text.
        - `start_time` ShowStartTimeRange
          - `start` string, date-time, required: Include only shows that started at or after this time.
          - `end` string, date-time, nullable: Include only shows that started at or before this time. Defaults to the end of the current hour.
      - `specific_shows` SpecificShows
        - `show_ids` string[], required: The shows to report on, in the order their rows appear. Every show must be hosted by the seller.
  - `report_url` string, nullable, required: URL of the generated report file. Null until the run is `completed`. See [Reports and Statements](/reports) for each report type's CSV columns.
  - `created_at` string, date-time, required: When the run was requested.
  - `updated_at` string, date-time, required: When the run was last updated.

## Other responses

- `404`: Report not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/whatnot/apis/whatnot-seller-api.md) - [All operations](https://skmtc.dev/whatnot/apis/whatnot-seller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whatnot/apis/whatnot-seller-api/revisions/e619f15f7ce0?raw)