---
title: "Validate Payout Sender"
method: POST
path: "/payout-sender/validate"
tags: ["Payout Sender"]
---

# Validate Payout Sender

`POST /payout-sender/validate`

Validates a payout sender (either an existing one by ID, or inline sender data) against a specific payout method's required fields.

Validate sender details using either the payout_sender_id or the provided payout_sender object details.

**Note:** Provide either payout_sender_id (to validate an existing sender) OR payout_sender (to validate inline data) — not both. payout_method_name is always required.

## Request body

- object
  - `payout_method_name` string, required — Payout method name (required)
  - `payout_sender_id` string — Payout sender ID to validate an existing sender (optional)
  - `payout_sender` object, nullable — Inline payout sender data to validate (optional)
    - `sender_name` string
    - `type` 'individual' | 'company'
    - `description` string, nullable
    - `metadata` object, nullable
    - `email` string, nullable
    - `organization_reference_id` string, nullable
    - `address_line1` string, nullable
    - `address_line2` string, nullable
    - `address_city` string, nullable
    - `address_state` string, nullable
    - `address_country` string, nullable
    - `address_zip_code` string, nullable
    - `phone_number` string, nullable
    - `phone_country_code` string, nullable
    - `phone_number_e164` string, nullable
    - `individual` object, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `dob` string, date, nullable
      - `nationality` string, nullable
      - `country_of_residence` string, nullable
      - `identification_type` 'WORK_PERMIT' | 'PASSPORT' | 'NATIONAL_ID' | 'DRIVERS_LICENCE' | 'OTHERS', nullable
      - `identification_custom_type` string, nullable
      - `identification_value` string, nullable
    - `company` object, nullable
      - `name` string, nullable
      - `registration_number` string, nullable
      - `incorporation_country` string, nullable

## Response `200`

OK

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) · [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finmo/finmo-api/revisions/1a3073c93930/schema)