WHwhatnot
Reports and Statements

List reports

List the seller's report generation runs, most recently requested first by default; set reverse=false for oldest first. Requires read:reports.

get/reports

Request

  • Base URL
    https://api.whatnot.com/seller-api/rest/v2
  • URL
    https://api.whatnot.com/seller-api/rest/v2/reports
  • 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

Query parameters

status'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled' nullable

Only list runs with this status.

limitinteger

Maximum results per page.

cursorstring nullable

Cursor from the previous page.

reverseboolean

Return descending order when true; ascending when false.

Response

Successful Response

next_cursorstring nullable required

Continuation cursor; null when there are no more results.

Example response

{
  "data": [
    {
      "created_at": "2026-09-20T18:30:00.000Z",
      "id": "0199a7c2-3f4e-7a1b-9c2d-4e5f6a7b8c9d",
      "report_parameters": {
        "end_date": "2026-09-08T00:00:00.000Z",
        "report_type": "seller_financial_report",
        "start_date": "2026-09-01T00:00:00.000Z"
      },
      "report_type": "seller_financial_report",
      "status": "pending",
      "updated_at": "2026-09-20T18:30:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.