Create an MX verification

Verify an ACH account by providing the raw account and transaction data from MX.

Parameters

`type`

enum

The type of verification.

Possible enum values

`mx`

Required

`mx`

object

Object containing account data from Plaid

Required

`mx.account`

object

The raw account data received from MX. See account data.

Required

`mx.transactions`

object[]

The a list of the raw transaction data received from MX See account transactions

Required

Returns

Returns the verification associated with the id.

cURL
Node.js
Python

POST /accounts/:account_id/verification
curl https://production.methodfi.com/accounts/acc_b9q2XVAnNFbp3/verification \
  -X POST \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "mx",
    "mx": {
      "account" : {
        "institution_code": "chase",
        "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
        "account_number": null,
        "apr": null,
        "apy": null,
        "available_balance": 1000.23,
        "available_credit": null,
        "balance": 1000.23,
        "cash_balance": 1000.32,
        "cash_surrender_value": 1000.23,
        "created_at": "2016-10-13T17:57:37+00:00",
        ...
      },
      "transactions": [
        {
          "account_guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
          "amount": 61.11,
          "category": "Groceries",
          "check_number": 15234,
          "check_number_string": "00015234",
          "created_at": "2016-10-06T09:43:42+00:00",
          "currency_code": "USD",
          "date": "2013-09-23",
          "description": "Whole Foods",
          "guid": "TRN-265abee9-889b-af6a-c69b-25157db2bdd9",
          "is_bill_pay": false,
          "is_direct_deposit": false,
          "is_expense": true,
          "is_fee": false,
          "is_income": false,
          ...
        },
        ...
      ]
    }
  }'

POST /accounts/:account_id/verification
const verification = await method
  .accounts('acc_b9q2XVAnNFbp3')
  .verification
  .create({
    type: 'mx',
    mx: {
      account : {
        institution_code: 'chase',
        guid: 'ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1',
        account_number: null,
        apr: null,
        apy: null,
        available_balance: 1000.23,
        available_credit: null,
        balance: 1000.23,
        cash_balance: 1000.32,
        cash_surrender_value: 1000.23,
        created_at: '2016-10-13T17:57:37+00:00',
        ...
      },
      transactions: [
        ...
      ],
    },  
  );

POST /accounts/:account_id/verification
verification = method
  .accounts('acc_b9q2XVAnNFbp3')
  .verification
  .create({
    'type': 'mx',
    'mx': {
      'account ': {
        'institution_code': 'chase',
        'guid': 'ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1',
        'account_number': None,
        'apr': None,
        'apy': None,
        'available_balance': 1000.23,
        'available_credit': None,
        'balance': 1000.23,
        'cash_balance': 1000.32,
        'cash_surrender_value': 1000.23,
        'created_at': '2016-10-13T17:57:37+00:00'
        ...
      },
      'transactions': [
        ...
      ]
    } 
  )

RESPONSE
{
  "id": "vrf_73TAQ8njUFsLJ",
  "status": "verified",
  "type": "mx",
  "error": null,
  "initiated_at": "1970-01-01T00:00:00.000Z",
  "pending_at": "1970-01-01T00:00:00.000Z",
  "verified_at": "2021-10-12T21:23:48.447Z",
  "disabled_at": "1970-01-01T00:00:00.000Z",
  "created_at": "2021-10-12T21:23:48.449Z",
  "updated_at": "2021-10-12T21:23:48.449Z"
}