---
title: "Get Payout Beneficiary by ID"
method: GET
path: "/payout-beneficiary/{payout_beneficiary_id}"
tags: ["Payout Beneficiary"]
---

# Get Payout Beneficiary by ID

`GET /payout-beneficiary/{payout_beneficiary_id}`

## Request

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

Retrieve details of an individual Payout beneficiary using the beneficiary ID (```po_ben_*```).

## Path parameters

- `payout_beneficiary_id` string, required

## Query parameters

- `include_deleted` boolean

## 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

## Other responses

- `404`: Not Found

## Changes

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

[Operation history](https://skmtc.dev/finmo/apis/finmo-api/changes/payout-beneficiary/:payout_beneficiary_id/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)