Skip to content

CLABE

Request

Use this endpoint to check that a Mexican bank account (CLABE) is valid and belongs to the applicant. Our system gets the name of the account holder from the bank and compares it with the name that you send.

The check is successful (status is true) when the account is valid and the name match score is equal to or higher than name_match_threshold.

For security, our system masks the CLABE and the account number in the response. Only the last 4 digits are visible.

Each request is charged.

This endpoint is not available for form-token authentication or test mode requests.

Security
API-Key
Bodyapplication/jsonrequired
clabestringrequired

CLABE (Clave Bancaria Estandarizada), 18 digits

Example:"012180001234567899"
first_namestringrequired
Example:"MARIO"
last_namestringrequired
Example:"EJEMPLO"
middle_namestring

Optional

Example:"ANTONIO"
name_match_thresholdnumber, [ 0 .. 100 ]required

Minimum name match score (0–100) for a successful check

Example:80
{
  "clabe": "012180001234567899",
  "first_name": "MARIO",
  "last_name": "EJEMPLO",
  "middle_name": "ANTONIO",
  "name_match_threshold": 80
}

Responses

OK

The request was successful, and our system returned an expected response.

When the account is not valid, account_valid is false and the errors array shows the reason.

Bodyapplication/json
dataobject
errorsArray of objects
Response
{
  "data": {
    "status": true,
    "clabe": "**************7899",
    "first_name": "MARIO",
    "last_name": "EJEMPLO",
    "middle_name": "ANTONIO",
    "account_valid": true,
    "service_beneficiary_name": "MARIO ANTONIO EJEMPLO PRUEBA",
    "service_account_number": "*******6789",
    "service_bank_name": "BBVA MEXICO",
    "service_country_code": "MX",
    "service_account_currency": "MXN",
    "name_match_threshold": 80,
    "name_match_score": 92
  },
  "errors": []
}