> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Microdeposits Overview
> Overview of microdeposit resource and field definitions
Microdeposits are small verification deposits used to confirm ownership of bank accounts for ACH transfer setup.
## Microdeposit Fields
| Field name | Data type | Definition |
| :------------------ | :-------- | :-------------------------------------------------------------------------------------------------------------------------------- |
| `account_name` | String | The name of the account associated with the verification. |
| `account_number` | String | The account number of the account associated with the microdeposit. |
| `account_type` | Integer | The general or parent type of the account associated with the microdeposit. Possible values are `1` (CHECKING) and `2` (SAVINGS). |
| `account_type_name` | String | The name of the account type. Possible values are `CHECKING` and `SAVINGS`. |
| `created_at` | String | The date and time the microdeposit was created, given in ISO 8601 format. |
| `email` | String | The end user's email address. |
| `error_code` | String | The code for the error. |
| `error_message` | String | A message explaining the error. |
| `first_name` | String | The end user's first name. |
| `guid` | String | The unique identifier for the microdeposit. Defined by MX. |
| `institution_name` | String | An easy-to-read name for an institution associated with the microdeposit, e.g., “Chase Bank” or “Wells Fargo Bank.” |
| `last_name` | String | The end user's last name. |
| `routing_number` | String | The routing number for the account associated with the microdeposit. |
| `status` | Integer | The current [status](#microdeposit-statuses) of the microdeposit. |
| `status_name` | String | The name of the current [status](#microdeposit-statuses). |
| `updated_at` | String | The date and time at which the microdeposit was last updated, given in ISO 8601 format. |
| `verified_at` | String | The date and time at which the microdeposit status changed from `DEPOSITED` to `VERIFIED`. |
## Microdeposit Statuses
| Status | Status name | Definiton |
| :----- | :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0` | `INITIATED` | The verification process has started. |
| `1` | `REQUESTED` | Microdeposits have been requested from the microdeposit provider. |
| `2` | `DEPOSITED` | Microdeposits have been deposited into the specified account and are ready to be verified by the end user. |
| `3` | `VERIFIED` | The microdeposit amounts have been successfully verified by the end user. |
| `4` | `ERRORED` | The microdeposit could not take place due to an ACH error. This may indicate an incorrect account or routing number. |
| `5` | `DENIED` | The microdeposit amounts provided by the end user were incorrect. |
| `6` | `PREVENTED` | 1. The microdeposit amounts provided by the end user were incorrect three times consecutively; the microdeposit verification cannot proceed.
2. The microdeposit has already been successfully verified, but an attempt is made to verify it again. |
| `9` | `PREINITIATED` | The microdeposit was created with client-provided `first_name`, `last_name`, and `email`. |
## Verification Fields
| Field name | Data type | Definition |
| :------------------------- | :-------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account_name` | String | The name of the account associated with the verification. |
| `account_number` | String | The account number of the account associated with the verification. |
| `account_number_guid` | String | The unique identifier for the account associated with the verification. Defined by MX. |
| `account_type` | Integer | The general or parent type of the account. Possible values are `1` (CHECKING) and `2` (SAVINGS). |
| `account_type_name` | String | The name of the account type. Possible values are `CHECKING` and `SAVINGS`. |
| `created_at` | String | The date and time the verification was created, given in ISO 8601 format. |
| `institution_name` | String | The human-readable name of the institution associated with the verification. |
| `micro_deposit_guid` | String | The unique identifier for the microdeposit associated with this verification. Defined by MX. |
| `routing_number` | String | The routing number for the account associated with the verification. |
| `updated_at` | String | The date and time at which the verification was last updated, given in ISO 8601 format. |
| `verification_method` | Integer | The [verification method](#verification-methods) used. |
| `verification_method_name` | String | The name of the [verification method](#verification-methods). |
| `verified_at` | String | When `"verification_method_name": "CREDENTIALS"`: The date and time at which the associated `account` was created.
When `"verification_method_name": "MICRO_DESPOSIT"`: The date and time at which the associated microdeposit status changed from `DEPOSITED` to `VERIFIED`. |
## Verification Methods
| Method | Method name |
| :----- | :-------------- |
| `0` | `CREDENTIALS` |
| `1` | `MICRO_DEPOSIT` |