Preview the SWIFT sender
Who the sender of a SWIFT payout will be, and whether it can send, by the same rules as initialize. Writes nothing; a preview never submits a profile. The org’s KYB comes first on both paths: not verified (and swift_sender_kyb_exempt off) answers eligible false with reason_code KYB_REQUIRED. With customer_id only the KYB status counts, not whether your organisation’s own sender details are complete. Without customer_id it previews your organisation (idp’s payout sender); a personal account previews its owner. With customer_id it previews that customer by its sender profile state: approved is eligible, also while a newer version is pending or rejected; not_submitted is SENDER_PROFILE_INCOMPLETE with missing_fields, or SENDER_NOT_VERIFIED when complete; pending or rejected with no approved version is SENDER_NOT_VERIFIED; expired is SENDER_EXPIRED; an approved version that lacks a field our partner requires (the customer’s email or phone number, for example) is SENDER_PROFILE_INCOMPLETE with missing_fields. An inactive customer (is_active false) is CUSTOMER_INACTIVE whatever its profile state, checked before any of these. Without customer_id the organisation’s sender details go through the same completeness check as initialize: a missing account_name, country, city, state, address, post_code or registration_number, which only your verified KYB record supplies, is eligible false with SENDER_PROFILE_INCOMPLETE and missing_fields; when only phone_number, email, business_type, registration_type or registration_issue_date are missing the preview stays eligible and lists them in missing_fields, and initialize needs them in beneficiary.sender. Not behind the active-org check.
Authorizations
Response
OK
Successful responses are wrapped in this envelope, and so are errors a handler answers itself (request body and field validation, some not-found and conflict cases, ORG_NOT_ACTIVE): success is false and error carries a code and message. Errors raised by authentication and by the services behind a handler are a Problem instead.