> ## Documentation Index
> Fetch the complete documentation index at: https://docs.methodfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a KBA Verification

export const entity_verification_session_name = "EntityVerificationSession";

export const ParamList = ({items = [], is_child = false}) => {
  return items.map(item => {
    const field_props = {
      id: Math.random().toString(),
      body: item.name,
      name: item.name,
      type: item.type,
      required: item.required
    };
    const enums = item.enums || [];
    const items = item.items || [];
    const has_items = items?.length > 0;
    const has_enums = enums?.length > 0;
    const should_default_open = item.defaultOpen || false;
    const render_child_item = () => {
      const child_props = {
        title: has_enums ? "Possible enum values" : "properties"
      };
      if (should_default_open) child_props.defaultOpen = true;
      const has_inline_enums = has_enums && enums.every(enum_item => typeof enum_item === 'string') && enums.map((enum_item, idx) => {
        const is_last = idx === enums.length - 1;
        const is_2nd_to_last = idx === enums.length - 2;
        return <>
            <code>{enum_item}</code>
            {is_last && ''}
            {is_2nd_to_last && ' or '}
            {!is_last && !is_2nd_to_last && ', '}
          </>;
      });
      const enum_list = has_enums && !has_inline_enums && <Accordion {...child_props}>
          {enums.map((enum_item, index) => <div key={`enum-${index}`}>
              <code>{enum_item.name}</code>
              <br />
              <p>{enum_item.description}</p>
            </div>)}
        </Accordion>;
      const item_list = has_items && <Expandable {...child_props}>
          <ParamList items={items || []} is_child />
        </Expandable>;
      return <>
          <p>
            {item.description}
            {has_inline_enums && [has_inline_enums.length > 1 ? ' One of ' : ' Must be ', ...has_inline_enums]}
          </p>

          {enum_list}
          {item_list}
        </>;
    };
    return is_child ? <ResponseField {...field_props}>{render_child_item()}</ResponseField> : <ParamField {...field_props}>{render_child_item()}</ParamField>;
  });
};

Knowledge-Based Authentication (KBA) creates a new {entity_verification_session_name} 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

<ParamList
  items={[
{
  name: "ent_id",
  type: "string",
  description: "The ID of the Entity.",
},
]}
/>

## Body

<ParamList
  items={[
{
  name: "type",
  type: "enum",
  required: true,
  description: `The ${entity_verification_session_name} will be verifying the Entity's identity.`,
  enums: ["identity"],
},
{
  name: "method",
  type: "enum",
  required: true,
  description: `The ${entity_verification_session_name} will be using Method's KBA verification process.`,
  enums: ["kba"],
},
{
  name: "kba",
  type: "object",
  required: true,
  description: "The KBA verification configuration.",
},
]}
/>

## Returns

Returns an {entity_verification_session_name} object.

<RequestExample>
  ```bash cURL theme={null}
  curl https://production.methodfi.com/entities/ent_hy3xhPDfWDVxi/verification_sessions \
    -X POST \
    -H "Method-Version: 2026-03-30" \
    -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
    -H "Content-Type: application/json" \
    -d '{
      "type": "identity",
      "method": "kba",
      "kba": {}
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await method
    .entities("ent_hy3xhPDfWDVxi")
    .verificationSessions
    .create({
      type: "identity",
      method: "kba",
      kba: {},
    });
  ```

  ```python Python theme={null}
  response = method
    .entities('ent_hy3xhPDfWDVxi')
    .verification_sessions
    .create({
      'type': 'identity',
      'method': 'kba',
      'kba': {}
    })
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
  }
  ```
</ResponseExample>