Skip to main content
GET
List account verifications
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Query Parameters

account_number
string

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

transfer_id
string

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

since
string<date-time>

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

Example:

"2026-01-01T00:00:00Z"

until
string<date-time>

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

Example:

"2026-03-31T23:59:59Z"

starting_after
string

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

Example:

"accv_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

ending_before
string

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

Example:

"accv_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

limit
integer

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

Example:

50

Response

List of account verifications for the current mode.

id
string
required

Unique identifier of the account verification.

Example:

"accv_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
required

Type of the object. Always account_verification.

counterparty
object
required

Details of the verified counterparty account.

mode
enum<string>
required

Whether the verification is live or test data.

Available options:
live,
test
Example:

"test"

reason
enum<string> | null
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.

Available options:
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
Example:

null

receipt_url
string | null
required

URL of the verification receipt, or null.

Example:

null

status
enum<string>
required

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

Available options:
pending,
succeeded,
failed
Example:

"pending"

transaction_date
string<date-time> | null
required

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

Example:

null

transfer_id
string | null
required

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

Example:

"tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"