---
title: "Payout Beneficiary Validation"
method: POST
path: "/payout-beneficiary/validate"
tags: ["Payout Beneficiary"]
---

# Payout Beneficiary Validation

`POST /payout-beneficiary/validate`

## Request

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

Validate beneficiary details using either the ```Payout_beneficiary_id``` or the provided ```Payout_beneficiary_param``` object details.

## Request body

- object
  - `is_beneficiary_name_match_enabled` boolean: If true, beneficiary name will be validated against the payout beneficiary name
  - `beneficiary_id` string, required: **Conditionally required:** Payout beneficiary reference (po_ben_*). (Either beneficiary_id or payout_beneficiary can be passed both cannot be passed)
  - `payout_method_name` string, required: Name of Payout Method
  - `payout_beneficiary` object, required: **Conditionally required:** Beneficiary Details. (Either of beneficiary_id or payout_beneficiary must be provided)
    - `type` 'company' | 'individual', required: type can be either 'individual' or 'company' based on the beneficiary
    - `beneficiary_name` string, required: Display Name of the payout beneficiary
    - `currency` string: Beneficiary Currency
    - `company` object, required: **Conditionally required:** Either an Individual object or a Company object must be specified, but not both.
      - `address_city` string: City
      - `address_country` string: Country
      - `address_line1` string: Address Line 1
      - `address_line2` string: Address Line 2
      - `address_state` string: State
      - `address_zip_code` string: Valid Zip/postal code
      - `company_email` string: Email Id of company
      - `incorporation_country` string: Incorporation Country
      - `name` string, required: Name
      - `phone_country_code` string: Phone country Code
      - `phone_number` string: Mobile Number
      - `registration_number` string: Company Registration Number
    - `individual` object, required: **Conditionally required:** Either an Individual object or a Company object must be specified, but not both.
      - `address_city` string: City
      - `address_country` string: Country
      - `address_line1` string: Address Line 1
      - `address_line2` string: Address Line 2
      - `address_state` string: State
      - `address_zip_code` string: Valid Zip/postal code
      - `country_of_residence` string
      - `dob` string: Date of Birth
      - `email` string: Email Id
      - `first_name` string, required: First Name
      - `identification_custom_type` string: Identity custom type
      - `identification_type` string: Type of identity document: WORK_PERMIT, PASSPORT, NATIONAL_ID, DRIVERS_LICENCE, OTHERS
      - `identification_value` string: Indentity Document Number
      - `last_name` string, required: Last Name
      - `nationality` string: Nationality
      - `phone_country_code` string: Phone Country Code
      - `phone_number` string: Phone Number
    - `description` string: Description of Transaction
    - `bank_country` string: Bank Country
    - `bank_name` string: Name of the Bank
    - `account_number` string: Account Number
    - `bsb` string: BSB (AU specific)
    - `bic_swift` string: Swift Code
    - `iban` string: IBAN (EU & UK specific)
    - `aba` string: ABA Routing Number (US Specific)
    - `sort_code` string: Sort Code (UK & IE specific)
    - `pay_id` string: NPP PayID (AU Specific)
    - `pay_id_type` string: Mention the type of PayID,It takes values ["EMAIL, PHONE, ORG, ABN"]
    - `ifsc` string: IFSC code
    - `branch_code` string: Branch Code
    - `bank_code` string: Bank Code
    - `organization_reference_id` string: A reference you can later use to identify this payment, such as an order number. Can only be alphanumeric and must be unique for Benefit.
    - `metadata` object: Custom Data

## Response `201`

Created

- object
  - `data` object
    - `aba` string, nullable
    - `account_number` string
    - `bank_code` string
    - `bank_country` string
    - `bank_name` string
    - `beneficiary_name` string
    - `bic_swift` string, nullable
    - `intermediary_bic_swift` string, nullable
    - `branch_code` string
    - `bsb` string
    - `company` 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
      - `company_email` string, nullable
      - `company_incorporation_country` string, nullable
      - `name` string
      - `phone_country_code` string, nullable
      - `phone_number` string, nullable
      - `phone_number_e164` string, nullable
      - `registration_number` string, nullable
      - `identification_type` string, nullable
      - `identification_value` string, nullable
    - `additional_data` object
      - `account_holder_name` string
      - `validation_status` string
      - `response_code` string
      - `validation_result` string
    - `created_at` string, date-time
    - `created_by` string
    - `currency` string
    - `description` string, nullable
    - `iban` string, nullable
    - `ifsc` string
    - `is_active` 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

- `400`: Bad Request

## Changes

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

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