POST
/
entities
/
{ent_id}
/
verification_sessions
curl https://production.methodfi.com/entities/ent_hy3xhPDfWDVxi/verification_sessions \
  -X POST \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc"
  -H "Content-Type: application/json" \
  -d '{
    "type": "identity",
    "method": "kba",
    "kba": {}
  }'
{
  "id": "evf_ywizPrR6WDxDG",
  "entity_id": "ent_hy3xhPDfWDVxi",
  "status": "in_progress",
  "type": "identity",
  "method": "kba",
  "kba": {
    "questions": [
      {
        "id": "qtn_xgP6cGhq34fHW",
        "text": "Which of these street names are you associated with?",
        "answers": [
          {
            "text": "21st (Correct)",
            "id": "ans_dbKCwDGwrrBgi"
          },
          {
            "text": "Majestic (Incorrect)",
            "id": "ans_8mpbq3AYPBt9z"
          },
          {
            "text": "Northland (Incorrect)",
            "id": "ans_bwtghTrmgRwDF"
          },
          {
            "text": "Southbridge (Incorrect)",
            "id": "ans_LjBPkzyVRfMGw"
          },
          {
            "text": "None of the Above (Incorrect)",
            "id": "ans_Cw6VGEwYTNdhD"
          }
        ]
      },
      {
        "id": "qtn_kmfdEftQ9zc6T",
        "text": "What is the monthly payment of your most recent auto loan or lease?",
        "answers": [
          {
            "text": "$201 - $300 (Correct)",
            "id": "ans_LXN83xnJAUNFb"
          },
          {
            "text": "$301 - $400 (Incorrect)",
            "id": "ans_C9RKnNAaxQn4m"
          },
          {
            "text": "$501 - $600 (Incorrect)",
            "id": "ans_9nqVjtNhXykLC"
          },
          {
            "text": "$601 - $700 (Incorrect)",
            "id": "ans_9qBFfNDy7fP4K"
          },
          {
            "text": "None of the Above (Incorrect)",
            "id": "ans_kEQHmaDrYDRF8"
          }
        ]
      },
      {
        "id": "qtn_6mWegPLBpAFxb",
        "text": "Which of the following is a current or previous employer?",
        "answers": [
          {
            "text": "Forward Lending Inc (Correct)",
            "id": "ans_EKi47D8wA6YN3"
          },
          {
            "text": "Network Appliance (Incorrect)",
            "id": "ans_prxEE8KhVkyWt"
          },
          {
            "text": "Northwest Community Healthcare (Incorrect)",
            "id": "ans_EYnd7dPzMbnaN"
          },
          {
            "text": "Russell Investment Group (Incorrect)",
            "id": "ans_7pCJRChVMN4tD"
          },
          {
            "text": "None of the Above (Incorrect)",
            "id": "ans_Mh7MMg7azapNq"
          }
        ]
      }
    ],
    "authenticated": false
  },
  "error": null,
  "created_at": "2024-04-11T19:23:44.727Z",
  "updated_at": "2024-04-11T19:23:44.727Z"
}

Knowledge-Based Authentication (KBA) creates a new for verifying an Entity’s identity via Method’s KBA verification process.

This starts the verification process by sending a list of security “out-of-wallet” questions in the response for the Entity to answer to verify their identity.

Path Parameters

ent_id
string

The ID of the Entity.

Body

type
enum
required

The EntityVerificationSession will be verifying the Entity's identity. Must be identity

method
enum
required

The EntityVerificationSession will be using Method's KBA verification process. Must be kba

kba
object
required

The KBA verification configuration.

Returns

Returns an object.

curl https://production.methodfi.com/entities/ent_hy3xhPDfWDVxi/verification_sessions \
  -X POST \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc"
  -H "Content-Type: application/json" \
  -d '{
    "type": "identity",
    "method": "kba",
    "kba": {}
  }'
{
  "id": "evf_ywizPrR6WDxDG",
  "entity_id": "ent_hy3xhPDfWDVxi",
  "status": "in_progress",
  "type": "identity",
  "method": "kba",
  "kba": {
    "questions": [
      {
        "id": "qtn_xgP6cGhq34fHW",
        "text": "Which of these street names are you associated with?",
        "answers": [
          {
            "text": "21st (Correct)",
            "id": "ans_dbKCwDGwrrBgi"
          },
          {
            "text": "Majestic (Incorrect)",
            "id": "ans_8mpbq3AYPBt9z"
          },
          {
            "text": "Northland (Incorrect)",
            "id": "ans_bwtghTrmgRwDF"
          },
          {
            "text": "Southbridge (Incorrect)",
            "id": "ans_LjBPkzyVRfMGw"
          },
          {
            "text": "None of the Above (Incorrect)",
            "id": "ans_Cw6VGEwYTNdhD"
          }
        ]
      },
      {
        "id": "qtn_kmfdEftQ9zc6T",
        "text": "What is the monthly payment of your most recent auto loan or lease?",
        "answers": [
          {
            "text": "$201 - $300 (Correct)",
            "id": "ans_LXN83xnJAUNFb"
          },
          {
            "text": "$301 - $400 (Incorrect)",
            "id": "ans_C9RKnNAaxQn4m"
          },
          {
            "text": "$501 - $600 (Incorrect)",
            "id": "ans_9nqVjtNhXykLC"
          },
          {
            "text": "$601 - $700 (Incorrect)",
            "id": "ans_9qBFfNDy7fP4K"
          },
          {
            "text": "None of the Above (Incorrect)",
            "id": "ans_kEQHmaDrYDRF8"
          }
        ]
      },
      {
        "id": "qtn_6mWegPLBpAFxb",
        "text": "Which of the following is a current or previous employer?",
        "answers": [
          {
            "text": "Forward Lending Inc (Correct)",
            "id": "ans_EKi47D8wA6YN3"
          },
          {
            "text": "Network Appliance (Incorrect)",
            "id": "ans_prxEE8KhVkyWt"
          },
          {
            "text": "Northwest Community Healthcare (Incorrect)",
            "id": "ans_EYnd7dPzMbnaN"
          },
          {
            "text": "Russell Investment Group (Incorrect)",
            "id": "ans_7pCJRChVMN4tD"
          },
          {
            "text": "None of the Above (Incorrect)",
            "id": "ans_Mh7MMg7azapNq"
          }
        ]
      }
    ],
    "authenticated": false
  },
  "error": null,
  "created_at": "2024-04-11T19:23:44.727Z",
  "updated_at": "2024-04-11T19:23:44.727Z"
}