Skip to main content

​
Update a verification

Update fields on a verification that hasn’t been approved yet. Use this to correct pre-filled data before the user completes KYC.
cURL
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Janet",
    "last_name": "Smith"
  }'

​
Updatable fields

FieldDescription
first_nameLegal first name
last_nameLegal last name
date_of_birthISO date
countryISO alpha-2 country code
personal_addressResidential address object
business_nameLegal business name
business_addressRegistered business address
business_structurellc, corp, sole_proprietorship, etc.
You can’t update a verification that’s already approved. The identity data is locked once verified. Delete it and create a new one if you need to start over.

​
Delete a verification

Remove a verification from an account. The data stays in our system but the verification is unlinked and won’t appear in the list.
cURL
curl -X DELETE https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY"
Response
{
  "id": "idpf_xxxxxxxxxxxxx",
  "deleted": true
}
After deleting, call POST /api/v1/verifications to start fresh with a new verification.
Deleting doesn’t cancel an in-flight KYC session — it unlinks the verification from the account. The session expires on its own at the provider.

​
Restart a verification

If a user’s KYC was declined or they need to redo it, you don’t need to delete and recreate. Call create with restart: true:
cURL
curl -X POST https://api.whop.com/api/v1/verifications \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_xxxxxxxxxxxxx",
    "kind": "individual",
    "restart": true
  }'
This abandons the old session and gives you a fresh session_url.

​
Authentication

All write endpoints require a Company API key with the identity:write scope.

​
Errors

StatusMessageWhen
400Cannot update an approved verification.Profile is already verified
400at least one field is requiredEmpty request body
401—Missing or invalid API key
403—API key lacks identity:write scope
404Verification not foundThe idpf_ ID doesn’t exist or isn’t visible