Sign in

v14

latestOpenAPI 3.1.02026-08-083813925.4 MB
Verifications

Retrieve Verification

Returns verifications for an account, including their status and any required actions.

get/verifications/{verification_id}

Path parameters

verification_idstring required

Verification profile ID, prefixed idpf_.

Response

verification retrieved

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": [
    {
      "errors": [
        {
          "code": "document_not_readable",
          "reason": "The uploaded image was too blurry to read."
        }
      ],
      "id": "inrqi_xxxxxxxxxxx",
      "label": "Bank Statement or a check for account ending in 4242",
      "options": [
        "sole_proprietorship"
      ],
      "requirement": "bank_statement",
      "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"
}