List reports
List the seller's report generation runs, most recently requested first by default; set reverse=false for oldest first. Requires read:reports.
Query Parameters
- Type: stringenumnullablestatus
Only list runs with this status.
valuespendingin_progresscompletedfailedcancelled - Type: integerlimitmin:1max:50
Maximum results per page.
- Type: stringcursormax length:2048nullable
Cursor from the previous page.
- Type: booleanreverse
Return descending order when true; ascending when false.
Responses
- application/json
- 422
Invalid status, limit, cursor, or reverse flag.
Request Example for get/reports
curl 'https://api.whatnot.com/seller-api/rest/v2/reports?limit=10&reverse=true' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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"
}
],
"next_cursor": "string"
}