Sign in

v1

latestOpenAPI 3.1.02026-07-228956435.8 KB
Account verifications

List account verifications

Lists the account verifications of your organization for the mode (live or test) of the API key used. Filter by account_number, transfer_id, or by date range with since and until. The list is paginated. Use the starting_after, ending_before, and limit query parameters to move through the list. The Link response header carries the URLs to navigate the paginated list.

get/account_verifications

Query parameters

account_numberstring

Counterparty account number to filter by. Use the standardized Mexican bank account number (CLABE).

transfer_idstring

Identifier of the verification transfer to filter by. Returns the account verification linked to this transfer.

sincestring date-time
Example:2026-01-01T00:00:00Z

Lower bound for the creation date. Returns account verifications created on or after this ISO 8601 datetime in UTC.

untilstring date-time
Example:2026-03-31T23:59:59Z

Upper bound for the creation date. Returns account verifications created on or before this ISO 8601 datetime in UTC.

starting_afterstring
Example:accv_2rNxBkOrlHoOYsZTyQYhA0o8Ek0

Cursor that fetches the next page of account verifications. Use the ID of the last account verification from the current page.

ending_beforestring
Example:accv_2rNxBkOrlHoOYsZTyQYhA0o8Ek0

Cursor that fetches the previous page of account verifications. Use the ID of the first account verification from the current page.

limitinteger
Example:50

Maximum number of account verifications to return per page. Ranges from 1 to 300. Defaults to 30.

Response

List of account verifications for the current mode.

idstring required

Unique identifier of the account verification.

object'account_verification' required

Type of the object. Always account_verification.

mode'live' | 'test' required

Whether the verification is live or test data.

reason'transfer_fail' | 'cep_unavailable' | 'non_existing_account' | 'blocked_account' | 'canceled_account' | 'wrong_currency' | 'account_not_from_receiving_institution' | 'missing_information' | 'wrong_payment_type' | 'wrong_operation_type' | 'account_type_does_not_correspond' | 'invalid_character' | 'exceeds_account_limit' | 'exceeds_account_monthly_payments_limit' | 'non_registered_mobile_phone' | 'does_not_accept_non_banxico_payments' | 'invalid_additional_information' | 'missing_payment_instruction_due_to_balance_limit_reached' | 'sender_client_protection_agreement' | 'optional_payment_not_accepted_by_recipient_institution' | 'codi_payment_without_quick_credit_notification' | 'duplicated_tracking_key' | 'expired_sender_institution_certificate' | 'unknown' | 'null' nullable required

Reason code explaining why the verification failed, or null when the verification succeeded. transfer_fail means Fintoc could not send the verification transfer. cep_unavailable means the Mexican central bank (Banxico) had not yet published the payment receipt (CEP) when the verification timed out, so Fintoc could not confirm the account; you can retry the verification later. unknown means the reason could not be determined. The remaining codes mirror the transfer return_reason and report why the counterparty institution returned the verification transfer: non_existing_account, blocked_account, canceled_account, wrong_currency, account_not_from_receiving_institution, missing_information, wrong_payment_type, wrong_operation_type, account_type_does_not_correspond, invalid_character, exceeds_account_limit, exceeds_account_monthly_payments_limit, non_registered_mobile_phone, does_not_accept_non_banxico_payments, invalid_additional_information, missing_payment_instruction_due_to_balance_limit_reached, sender_client_protection_agreement, optional_payment_not_accepted_by_recipient_institution, codi_payment_without_quick_credit_notification, duplicated_tracking_key, and expired_sender_institution_certificate.

receipt_urlstring nullable required

URL of the verification receipt, or null.

status'pending' | 'succeeded' | 'failed' required

Status of the verification. One of pending (in progress), succeeded (ownership confirmed), or failed (could not be completed).

transaction_datestring date-time nullable required

Date and time when the verification was performed, as an ISO 8601 datetime in UTC, or null.

transfer_idstring nullable required

Identifier of the transfer issued to verify the account, or null.

Example response

[
  {
    "id": "accv_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
    "counterparty": {
      "account_number": "132969000000000190",
      "account_type": "clabe",
      "holder_id": "000000000",
      "holder_name": "Test Customer 1",
      "institution": {
        "id": "40012",
        "name": "BBVA Mexico",
        "country": "mx"
      }
    },
    "mode": "test",
    "status": "pending",
    "transfer_id": "tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
  }
]