---
title: "List all Payouts"
method: GET
path: "/payout"
tags: ["Payout"]
---

# List all Payouts

`GET /payout`

## Request

- Base URL: `https://api.finmo.net/v1`
- URL: `https://api.finmo.net/v1/payout`
- Auth: HTTP basic

Retrieve a list of all the Payouts. You can filter the list with query parameters. 

This API comes with Pagination support, you can customize ```limit``` and ```page``` query parameters as per the requirements.

## Query parameters

- `limit` integer
- `page` integer
- `status` string
- `payout_method_name` string
- `created_at` string
- `start_time` integer
- `end_time` integer

## Response `200`

OK

- object
  - `data` object
    - `beneficiary_amount` integer
    - `beneficiary_currency` string
    - `created_at` string, date-time
    - `debit_wallet_id` string
    - `debit_wallet_transaction_id` string
    - `description` string, nullable
    - `fees_currency` string
    - `fees_including_tax` string, nullable
    - `fees_wallet_id` string
    - `fees_wallet_transaction_id` string, nullable
    - `fees_without_tax` string, nullable
    - `fx_conversion_id` string, nullable
    - `fx_rate` integer
    - `fx_rate_id` string, nullable
    - `is_fees_charged` boolean
    - `is_paid` boolean
    - `is_reconciled` boolean
    - `is_returned` boolean
    - `metadata` object
      - `any-custom-ref` string
    - `org_id` string
    - `organization_reference_id` string, nullable
    - `paid_amount` string, nullable
    - `paid_at` string, date-time, nullable
    - `paid_currency` string, nullable
    - `payout_beneficiary_id` string, nullable
    - `payout_beneficiary_param` object
      - `account_number` string
      - `bank_country` string
      - `bsb` string
      - `currency` string
      - `individual` object
      - `name` string
      - `type` string
    - `payout_id` string
    - `payout_method_name` string
    - `payout_method_param` object
    - `payout_returned_transaction_id` string, nullable
    - `payout_returned_wallet_id` string, nullable
    - `payout_returned_wallet_transaction_id` string, nullable
    - `payout_sender_id` string, nullable
    - `payout_sender_param` object
    - `payout_type` string
    - `purpose_code` string
    - `returned_amount` string, nullable
    - `returned_at` string, date-time, nullable
    - `returned_currency` string, nullable
    - `sender_amount` integer
    - `sender_currency` string
    - `statement_descriptor` string
    - `status` string
    - `tax_on_fees` string, nullable
    - `transaction_id` string, nullable
    - `updated_at` string, date-time
    - `webhook_url` string, uri, nullable
  - `request_id` string
  - `request_time` string, date-time
  - `status_code` integer
  - `status_text` string
  - `success` boolean

## Changes

- **2026-11-03** `39e5e5ab5c3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/finmo/apis/finmo-api/changes/payout/get.md)

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) - [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finmo/apis/finmo-api/revisions/39e5e5ab5c3a?raw)