Identity Verification
Create a KBA Verification
- Introduction
- Authentication
- Environments
- Idempotency
- Expanding Resources
- Request IDs
- Versioning
- Pagination
- Metadata
- Errors
- The entity endpoint
- POSTCreate an Individual
- POSTCreate a Corporation
- PUTUpdate an Entity
- GETList all Entities
- GETRetrieve an Entity
- Connect
- Verification Sessions
- Credit Scores
- Identities
- Products
- Subscriptions
- Consent
- The account endpoint
- POSTCreate an Account
- GETList all Accounts
- GETRetrieve an Account
- Updates
- Transactions
- Card Brand
- Payoffs
- Balances
- Sensitive
- Products
- Subscriptions
- Verification Sessions
- Consent
- The payment endpoint
- POSTCreate a Payment
- GETList all Payments
- GETRetrieve a Payment
- DELDelete a Payment
- Merchants
- Webhooks
- Reports
- Simulations (Dev)
- Health Check
API Reference
Entities
Accounts
Payments
Supporting Endpoints
Identity Verification
Create a KBA Verification
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
requiredThe EntityVerificationSession will be verifying the Entity's identity. Must be identity
method
enum
requiredThe EntityVerificationSession will be using Method's KBA verification process. Must be kba
kba
object
requiredThe 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"
}
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"
}