Create report
Queues an asynchronous report. The response returns immediately with status: PENDING; poll GET /reports/:reportId or wait for the merchant email. Periods cannot exceed 90 days. Requires the REPORTS_WRITE scope.
POST
https://api.pandabase.io/v2/core/stores/{storeId}/reports/ Authentication
Requires a bearer token (sk_…) or an API key in the header Authorization.
Path parameters
storeId string required (length 12–48)
Header parameters
idempotency-key string (length 8–32)
Body parameters
type enum required No description.
periodStart date-time required (format date-time)
periodEnd date-time required (format date-time)
formats array of enum No description.
Response 201
Default Response
ok enum required (one of true)
data object required No description.
Response 400
Default Response
ok enum required (one of false)
error string required No description.
Response 404
Default Response
ok enum required (one of false)
error string required No description.
Response 429
Default Response
ok enum required (one of false)
error string required No description.
Request
curl -X POST https://api.pandabase.io/v2/core/stores/:storeId/reports/ \ -H "Content-Type: application/json" \ -d '{"type":"PAYMENT_ACTIVITY","periodStart":"2024-01-01T00:00:00Z","periodEnd":"2024-01-01T00:00:00Z","formats":["CSV"]}'Response
{ "ok": true, "data": { "id": "rpt_8h4t6sqzy3x9w5n2k1m0vqbf", "type": "PAYMENT_ACTIVITY", "status": "SUCCEEDED", "formats": [ "CSV", "JSON" ], "periodStart": "2026-04-01T00:00:00.000Z", "periodEnd": "2026-05-01T00:00:00.000Z", "rowCount": 1247, "sizeBytes": 412980, "durationMs": 8412, "errorMessage": null, "requestedByAccountId": null, "requestedByTokenId": "stk_4tzcbfp2v8q1mzwxj5h0r1n", "startedAt": "2026-05-22T10:00:00.100Z", "completedAt": "2026-05-22T10:00:08.512Z", "createdAt": "2026-05-22T10:00:00.000Z", "updatedAt": "2026-05-22T10:00:08.512Z" }}