---
title: "Get an account verification"
method: GET
path: "/account_verifications/{id}"
tags: ["Account verifications"]
---

# Get an account verification

`GET /account_verifications/{id}`

Retrieves the details of an account verification by its ID.

## Path parameters

- `id` string, required

## Response `200`

The requested account verification.

- AccountVerification
  - `id` string, required — Unique identifier of the account verification.
  - `object` 'account_verification', required — Type of the object. Always `account_verification`.
  - `counterparty` object, required — Details of the verified counterparty account.
    - `account_number` string, required — Account number of the verified counterparty. The 18-digit standardized Mexican bank account number (CLABE).
    - `account_type` string, required — Type of the counterparty account, in lowercase. For Mexican account verifications, `clabe`.
    - `holder_id` string, nullable, required — Tax identifier of the account holder, or `null`. The Mexican tax ID (RFC).
    - `holder_name` string, nullable, required — Name of the account holder, or `null`.
    - `institution` object, required — Financial institution of the counterparty.
      - `id` string, required — Institution identifier.
      - `name` string, required — Institution name.
      - `country` 'mx', required — ISO 3166-1 alpha-2 country code of the institution, in lowercase. Always `mx`.
  - `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_url` string, 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_date` string, date-time, nullable, required — Date and time when the verification was performed, as an ISO 8601 datetime in UTC, or `null`.
  - `transfer_id` string, nullable, required — Identifier of the transfer issued to verify the account, or `null`.

## Other responses

- `401` — Invalid or missing API key.
- `403` — Account verifications are available only for Mexico organizations.
- `404` — No account verification with the given ID exists in your organization.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/revisions/9dafa63688a3/schema)