# List Reports Retrieve a paginated list of generated reports. ## Request ### Headers ### Query Parameters ## Response ### Success (200 OK) ```json { "success": true, "data": [ { "id": "rep_550e8400-e29b-41d4-a716-446655440000", "merchantId": "mer_xxxxx", "type": "transactions", "format": "csv", "status": "completed", "startDate": "2024-01-01T00:00:00.000Z", "endDate": "2024-01-31T23:59:59.999Z", "downloadUrl": "https://api.zenpayz.com/merchant/api/v1/reports/rep_550e8400/download", "fileSize": 125000, "rowCount": 1500, "createdAt": "2024-01-15T10:30:00.000Z", "completedAt": "2024-01-15T10:32:00.000Z" } ], "pagination": { "page": 1, "limit": 20, "total": 45, "totalPages": 3 } } ``` ## Examples ```bash curl -X GET "https://api.zenpayz.com/merchant/api/v1/reports?status=completed&limit=10" \ -H "Authorization: Bearer zp_test_xxxxx" \ -H "X-Timestamp: 2024-01-15T10:30:00.000Z" \ -H "X-Signature: a1b2c3d4e5f6..." \ -H "X-Secret-Salt: your_secret_salt" ``` ```javascript const { data, pagination } = await zenpays.reports.list({ status: 'completed', limit: 10, }); console.log(`Found ${pagination.total} reports`); ``` ## Related Endpoints - [Generate Report](/docs/rest-api/endpoints/reports/generate-report) - [Get Report](/docs/rest-api/endpoints/reports/get-report) - [Download Report](/docs/rest-api/endpoints/reports/download-report)