# List Payouts :::danger[Deprecated — Do Not Use] This endpoint is **deprecated** and will be removed in a future release. It is no longer maintained and may produce unexpected behavior. **Use [Payout Intents](/docs/rest-api/endpoints/payout-intents/list-payout-intents) instead.** ::: Retrieve a paginated list of payouts with optional filters. ## Request ### Headers ### Query Parameters ## Response ### Success (200 OK) ```json { "success": true, "data": [ { "payoutId": "pay_xxxxx", "merchantId": "mer_xxxxx", "amount": 10000, "currency": "INR", "status": "succeeded", "externalPayoutId": "pout_xxxxx", "processingFee": 25, "totalDebitedAmount": 10025, "estimatedCompletion": "2024-01-15T11:00:00.000Z", "createdAt": "2024-01-15T10:30:00.000Z", "metadata": {} } ], "pagination": { "page": 1, "limit": 20, "total": 150, "totalPages": 8 } } ``` ## Examples ```bash curl -X GET "https://api.zenpays.com/merchant/api/v1/payouts?status=succeeded&limit=50" \ -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.payouts.list({ status: 'succeeded', limit: 50, }); ```