---
title: "List payouts"
method: GET
path: "/payouts"
tags: ["X Payouts"]
---

# List payouts

`GET /payouts`

List payouts for a given RazorpayX account. Filter by contact, fund account, date range, or status.

## Query parameters

- `account_number` string, required
- `contact_id` string
- `fund_account_id` string
- `from` integer
- `to` integer
- `count` integer
- `skip` integer

## Response `200`

List of payouts

- object
  - `entity` 'collection'
  - `count` integer
  - `items` Payout[]
    - `id` string — Payout ID (pout_*)
    - `entity` 'payout'
    - `fund_account_id` string
    - `fund_account` FundAccount — Payout destination linked to a Contact. Immutable after creation.
      - `id` string — Fund account ID (fa_*)
      - `entity` 'fund_account'
      - `contact_id` string
      - `account_type` 'bank_account' | 'vpa' | 'card' | 'wallet'
      - `active` boolean
      - `batch_id` string
      - `bank_account` object
        - `ifsc` string
        - `bank_name` string
        - `name` string
        - `account_number` string
      - `vpa` object
        - `username` string
        - `handle` string
        - `address` string
      - `card` object
        - `last4` string
        - `network` string
        - `type` string
        - `issuer` string
        - `input_type` 'razorpay_token' | 'service_provider_token' | 'raw'
      - `created_at` integer
      - `wallet` object — Amazon Pay wallet details. Required when account_type=wallet.
        - `provider` 'amazonpay'
        - `phone` string — 10-digit phone with country code, e.g. +919876543210
        - `email` string, email
        - `name` string — Wallet holder name. Case-sensitive. Supported: a-z, A-Z, 0-9, space, ', -, _, /, (, ), .
    - `amount` integer — Amount in paise (min 100)
    - `currency` 'INR'
    - `fees` integer
    - `tax` integer
    - `mode` 'NEFT' | 'RTGS' | 'IMPS' | 'UPI' | 'card' | 'amazonpay' — Transfer mode — case-sensitive. amazonpay limited to ₹10,000 per transaction; no custom narration allowed.
    - `utr` string — Unique Transaction Reference from bank
    - `reference_id` string
    - `debit_account_number` string
    - `narration` string
    - `purpose` 'refund' | 'cashback' | 'payout' | 'salary' | 'utility bill' | 'vendor bill'
    - `fee_type` string
    - `status` 'queued' | 'pending' | 'rejected' | 'processing' | 'processed' | 'cancelled' | 'reversed' | 'failed'
    - `status_details` object
      - `description` string
      - `source` string
      - `reason` string
    - `batch_id` string
    - `notes` object
    - `created_at` integer
    - `queue_if_low_balance` boolean — true: queue payout when account balance is insufficient. false (default): fail immediately.

## Other responses

- `400` — Bad request. Invalid parameters or missing required fields.
- `401` — Authentication failed. Invalid or missing API key credentials.
- `429` — Rate limit exceeded. Implement exponential backoff with jitter before retrying.
- `500` — Internal server error.

---

[API](https://skmtc.net/curlec/apis/razorpay-api.md) · [All operations](https://skmtc.net/curlec/apis/razorpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/curlec/razorpay-api/versions/824ca9e6faef/schema)