Sign in

v9

OpenAPI 3.1.02026-08-043703845.2 MB
Verifications

Update Verification

Updates editable profile details or submits answers for items returned in requested_information. Once a verification is approved its profile details are locked and can no longer be edited.

patch/verifications/{verification_id}

Path parameters

verification_idstring required

Verification profile ID, prefixed idpf_.

Request body

OR

Response

verification updated

business_namestring nullable

Legal business name.

business_structurestring nullable

Legal entity structure of the business, such as private_corporation or sole_proprietorship. Supported values vary by country of incorporation — see Business structures.

countrystring nullable

Two-letter ISO 3166-1 country code, for example US, DE, or GB.

created_atstring

When the verification profile was created, as an ISO 8601 timestamp.

date_of_birthstring nullable

Formatted as YYYY-MM-DD.

first_namestring nullable
idstring

Verification profile ID, prefixed idpf_.

kind'individual' | 'business'
last_namestring nullable
session_urlstring nullable

Hosted verification session URL for the user to complete identity checks. Expires 7 days after creation.

status'not_started' | 'pending' | 'processing' | 'manual_review' | 'approved' | 'rejected' | 'action_required'

Current verification state. not_started before any session exists; pending while a session needs the user's input; processing while the provider reviews documents; action_required when requested_information needs answers; manual_review during a manual compliance review — nothing to submit, usually done within 3 business days; approved on success; rejected on failure. Call Create Verification again to start a new session.

updated_atstring

When the verification profile was last updated, as an ISO 8601 timestamp.

Example response

{
  "address": {
    "city": "New York",
    "country": "US",
    "line1": "123 Spring Street",
    "line2": "Apt 4B",
    "postal_code": "10012",
    "state": "NY"
  },
  "business_name": "Pickaxe Labs LLC",
  "business_structure": "sole_proprietorship",
  "country": "US",
  "created_at": "2026-06-01T12:00:00.000Z",
  "date_of_birth": "1990-01-01",
  "first_name": "Alex",
  "id": "idpf_xxxxxxxxxxxx",
  "last_name": "Rivera",
  "requested_information": [
    {
      "description": "A government-issued photo ID used to confirm your identity.",
      "error_message": "Document image was too blurry to read.",
      "field": "identity_document",
      "id": "inrqi_xxxxxxxxxxx",
      "label": "Identity Document",
      "options": [
        "sole_proprietorship"
      ],
      "requested_files": [
        {
          "category": "identity_document_front",
          "kind": "Bank Statement",
          "label": "Front of ID Document"
        }
      ],
      "type": "files"
    }
  ],
  "required_documents": [
    {
      "document": "id_card_front",
      "rejection_reason": "Document image was too blurry to read."
    }
  ],
  "session_url": "https://verify.whop.com/session/idpf_xxxxxxxxxxxx",
  "updated_at": "2026-06-02T12:00:00.000Z"
}