Verify an external account

Resolves and verifies a recipient's account with the destination
institution before you add them as an external account. Use it to
confirm the account holder's name and that the account is reachable, so
you can show the resolved name and avoid failed transfers.

Pass at least one identifier: account_number, iban, phone, or
clabe. The service detects the account type, validates its format,
then resolves the name with the institution.

  • is_verified: true — the account resolved. account_name holds
    the confirmed holder name.
  • is_verified: false — the account could not be resolved. Any
    institutions that matched the identifier are returned in
    institutions so the user can pick one and retry.

Verification is supported for bank accounts and mobile money today.
Other types (IBAN, SWIFT) return is_verified: false.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Supply at least one of: account_number, iban, phone, clabe, or routing_number. You can also include bic, country_code, and account_owner_type to narrow the lookup to the right institution and flow.

string | null

Bank account number.

uuid | null

Institution UUID from GET /v1/external-accounts/institutions. Speeds up and disambiguates resolution.

string | null

Mobile money number in international format.

string | null
string | null
string | null

Mexican CLABE account number.

string | null
string | null

ISO 3166-1 alpha-2 country code.

string | null
enum

Beneficiary owner type. Lets the institution pick the right flow for business versus individual recipients.

Allowed:
Headers
string
required

Business/tenant identifier for authorization

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json