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

# Verification

A Verification represents an identity review for a person or business. Accounts and users complete verification when Whop needs to confirm who they are before enabling payouts or compliance-sensitive workflows.

Use the Verifications API to start or resume a hosted verification session, check review status, and submit requested details or documents. If `requested_information` contains items, submit answers with [Update Verification](/api-reference/beta/verifications/update-verification).

## Endpoints

| Endpoint                                                                         | Request                                                                                 |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [List Verifications](/api-reference/beta/verifications/list-verifications)       | <Badge color="blue" size="sm" stroke>GET</Badge> `/verifications`                       |
| [Create Verification](/api-reference/beta/verifications/create-verification)     | <Badge color="green" size="sm" stroke>POST</Badge> `/verifications`                     |
| [Retrieve Verification](/api-reference/beta/verifications/retrieve-verification) | <Badge color="blue" size="sm" stroke>GET</Badge> `/verifications/{verification_id}`     |
| [Update Verification](/api-reference/beta/verifications/update-verification)     | <Badge color="orange" size="sm" stroke>PATCH</Badge> `/verifications/{verification_id}` |
| [Delete Verification](/api-reference/beta/verifications/delete-verification)     | <Badge color="red" size="sm" stroke>DELETE</Badge> `/verifications/{verification_id}`   |

## Attributes

<Columns cols={2}>
  <Column>
    <ResponseField name="id" type="string">
      Verification profile ID, prefixed `idpf_`.
    </ResponseField>

    <ResponseField name="address" type="object | null">
      Personal or business address on the verification profile, with `line1`,
      `line2`, `city`, `state`, `postal_code`, and `country`. `null` when no address
      is set.
    </ResponseField>

    <ResponseField name="business_name" type="string | null">
      Legal business name on a business verification.
    </ResponseField>

    <ResponseField name="business_structure" type="string | null">
      Legal entity structure of the business, such as `private_corporation` or
      `sole_proprietorship`. Supported values vary by country of incorporation — see
      [Business structures](/developer/verification/business-structures).
    </ResponseField>

    <ResponseField name="country" type="string | null">
      ISO 3166-1 alpha-2 country code for the individual or business being verified.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      When the verification profile was created, as an ISO 8601 timestamp.
    </ResponseField>

    <ResponseField name="date_of_birth" type="string | null">
      Date of birth for an individual verification, formatted as `YYYY-MM-DD`.
    </ResponseField>

    <ResponseField name="first_name" type="string | null">
      First name on an individual verification.
    </ResponseField>

    <ResponseField name="kind" type="string">
      Verification type: `individual` for a person or `business` for a business.

      Available options: `individual`, `business`
    </ResponseField>

    <ResponseField name="last_name" type="string | null">
      Last name on an individual verification.
    </ResponseField>

    <ResponseField name="requested_information" type="object[]">
      Fields or documents Whop still needs before review can continue. Submit answers with the Update Verification endpoint.

      <Accordion title="Properties" defaultOpen={true}>
        <ResponseField name="id" type="string">
          Requested information item ID, prefixed `inrqi_`. Include this ID when
          submitting an answer.
        </ResponseField>

        <ResponseField name="description" type="string | null">
          Additional instructions for this requested item, or `null`.
        </ResponseField>

        <ResponseField name="error_message" type="string | null">
          Reason a previously submitted value was rejected. `null` if no submitted value
          has been rejected.
        </ResponseField>

        <ResponseField name="field" type="string">
          Stable field key, such as `ssn` or `business_description`.
        </ResponseField>

        <ResponseField name="label" type="string">
          Human-readable label for the field, such as `Social Security Number`.
        </ResponseField>

        <ResponseField name="options" type="string[]">
          Allowed values for a `select` field (e.g. account\_type, business\_structure) —
          the submitted value must be one of these; empty for other types.
        </ResponseField>

        <ResponseField name="requested_files" type="object[]">
          Document upload slots for this item. Present when `type` is `files`; upload one file for each required slot and include the slot's `category` when submitting the answer.

          <Accordion title="Properties" defaultOpen={true}>
            <ResponseField name="category" type="string | null">
              File category to include with the uploaded file so Whop can route the document
              correctly. `null` for a generic upload.
            </ResponseField>

            <ResponseField name="is_optional" type="boolean">
              Whether this slot can be left empty.
            </ResponseField>

            <ResponseField name="kind" type="string | null">
              Specific document type requested, such as `Bank Statement`. `null` for
              standard identity and business document uploads.
            </ResponseField>

            <ResponseField name="label" type="string">
              Label for this upload slot, such as `Front of ID Document`.
            </ResponseField>

            <ResponseField name="multiple" type="boolean">
              Whether this slot accepts more than one file.
            </ResponseField>
          </Accordion>
        </ResponseField>

        <ResponseField name="type" type="string | null">
          Input type expected for this item: `text`, `date`, `phone`, `address`, `files`, or `select`.
        </ResponseField>
      </Accordion>
    </ResponseField>

    <ResponseField name="session_url" type="string | null">
      Hosted verification session URL for the user to complete identity checks.
      Expires 7 days after creation. Omitted unless this verification's own status
      is `pending`; `null` if `pending` with no active session.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current verification state. `not_started` before any session has been created; `pending` while a session is in progress; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.

      Available options: `not_started`, `pending`, `approved`, `rejected`, `action_required`
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      When the verification profile was last updated, as an ISO 8601 timestamp.
    </ResponseField>
  </Column>

  <Column>
    <div className="api-resource-sticky-example">
      ```json Verification theme={null}
      {
      	"id": "idpf_xxxxxxxxxxxx",
      	"address": {
      		"city": "New York",
      		"country": "US",
      		"line1": "123 Spring Street",
      		"postal_code": "10012",
      		"state": "NY"
      	},
      	"business_name": null,
      	"business_structure": null,
      	"country": "US",
      	"created_at": "2026-06-01T12:00:00Z",
      	"date_of_birth": "1990-01-01",
      	"first_name": "Alex",
      	"kind": "individual",
      	"last_name": "Rivera",
      	"requested_information": [
      		{
      			"id": "inrqi_xxxxxxxxxxx",
      			"description": "A government-issued photo ID used to confirm your identity.",
      			"error_message": null,
      			"field": "identity_document",
      			"label": "Identity Document",
      			"options": [],
      			"requested_files": [
      				{
      					"category": "identity_document_front",
      					"is_optional": false,
      					"kind": null,
      					"label": "Front of ID Document",
      					"multiple": false
      				},
      				{
      					"category": "identity_document_back",
      					"is_optional": false,
      					"kind": null,
      					"label": "Back of ID Document",
      					"multiple": false
      				}
      			],
      			"type": "files"
      		}
      	],
      	"session_url": "https://verify.whop.com/session/idpf_xxxxxxxxxxxx",
      	"status": "action_required",
      	"updated_at": "2026-06-02T12:00:00Z"
      }
      ```
    </div>
  </Column>
</Columns>