---
title: "Get All Payout Beneficiary"
method: GET
path: "/payout-beneficiary"
tags: ["Payout Beneficiary"]
---

# Get All Payout Beneficiary

`GET /payout-beneficiary`

## Request

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

Retrieve a list of all the Payout beneficiaries. Use query parameters to filter the list.

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

## Query parameters

- `type` 'company' | 'individual'
- `include_deleted` boolean
- `created_at` string, date
- `start_time` integer
- `end_time` integer
- `limit` integer
- `page` integer

## Response `200`

OK

- object
  - `data` object[]
    - `aba` string, nullable
    - `account_number` string
    - `bank_code` string
    - `bank_country` string
    - `bank_name` string
    - `bic_swift` string, nullable
    - `intermediary_bic_swift` string, nullable
    - `branch_code` string
    - `bsb` string
    - `created_at` string, date-time
    - `created_by` string
    - `currency` string
    - `description` string, nullable
    - `iban` string, nullable
    - `ifsc` string
    - `individual` object
      - `address_city` string, nullable
      - `address_country` string, nullable
      - `address_line1` string, nullable
      - `address_line2` string, nullable
      - `address_state` string, nullable
      - `address_zip_code` string, nullable
      - `country_of_residence` string, nullable
      - `dob` string, nullable
      - `email` string, nullable
      - `first_name` string
      - `identification_custom_type` string, nullable
      - `identification_type` string, nullable
      - `identification_value` string, nullable
      - `last_name` string
      - `nationality` string, nullable
      - `phone_country_code` string, nullable
      - `phone_number` string, nullable
      - `phone_number_e164` string, nullable
    - `additional_data` object
      - `change_log` object[]
        - `timestamp` string, date-time
        - `updated_by` string
        - `fields` object
          - `key_name` object
            - `prev_value` string
            - `new_value` string
    - `is_active` boolean
    - `is_deleted` boolean
    - `metadata` string, nullable
    - `org_id` string
    - `organization_reference_id` string
    - `pay_id` string, nullable
    - `pay_id_type` string
    - `payout_beneficiary_id` string
    - `proxy_type` string
    - `proxy_value` string
    - `sort_code` string, nullable
    - `type` string
    - `updated_at` string, date-time
  - `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-beneficiary/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)