> ## 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 an account that needs to receive payouts or satisfy compliance requirements. It tracks the verification status and the latest provider error when more information is needed.

Use the Verifications API to create a verification session, list or retrieve verification status, update submitted identity details, and delete a verification when it should no longer be used.

## Endpoints

| Endpoint                                                                               | Request                                                                                 |
| -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [List Verifications](/api-reference/beta/verifications/list-verifications-for-account) | <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="address" type="object | null" />

    <ResponseField name="business_name" type="string | null" />

    <ResponseField name="business_structure" type="string | null" />

    <ResponseField name="country" type="string | null">
      ISO 3166-1 alpha-2 country code (e.g. `US`, `GB`). For individuals this is the
      country of citizenship or residence reported by the identity provider; for
      businesses this is the country of incorporation.
    </ResponseField>

    <ResponseField name="created_at" type="string" />

    <ResponseField name="date_of_birth" type="string | null" />

    <ResponseField name="first_name" type="string | null" />

    <ResponseField name="id" type="string">
      The verification ID, e.g. idpf\_\*
    </ResponseField>

    <ResponseField name="kind" type="string">
      Available options: `individual`, `business`
    </ResponseField>

    <ResponseField name="last_name" type="string | null" />

    <ResponseField name="requested_information" type="object[]">
      The outstanding information this verification still needs — payout RFIs and audit RMIs, one uniform shape.

      <Accordion title="Properties" defaultOpen={true}>
        <ResponseField name="description" type="string | null">
          Additional guidance for the field beyond the label.
        </ResponseField>

        <ResponseField name="error_message" type="string | null">
          The reason a previously submitted value was rejected, or null.
        </ResponseField>

        <ResponseField name="field" type="string">
          Stable snake\_case key for the field (e.g. ssn, business\_description).
        </ResponseField>

        <ResponseField name="id" type="string">
          The requested information item id (inrqi\_\*). Use this when answering.
        </ResponseField>

        <ResponseField name="label" type="string">
          Human-readable label for the field (e.g. "Social Security Number").
        </ResponseField>

        <ResponseField name="requested_files" type="object[]">
          Upload slots for a files item — always at least one when type is `files`, empty otherwise.

          <Accordion title="Properties" defaultOpen={true}>
            <ResponseField name="category" type="string | null">
              Identifier to send back with the uploaded file so it routes 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">
              Provider-specific document kind, when applicable.
            </ResponseField>

            <ResponseField name="label" type="string">
              Label for this upload slot (e.g. "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">
          How to render the input: text, date, phone, address, or files.
        </ResponseField>
      </Accordion>
    </ResponseField>

    <ResponseField name="session_url" type="string | null" />

    <ResponseField name="status" type="string">
      Available options: `not_started`, `pending`, `approved`, `rejected`,
      `action_required`
    </ResponseField>

    <ResponseField name="updated_at" type="string" />
  </Column>

  <Column>
    <div className="api-resource-sticky-example">
      ```json Verification theme={null}
      {
      	"address": {
      		"city": "New York",
      		"country": "US",
      		"line1": "123 Spring Street",
      		"postal_code": "10012",
      		"region": "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",
      	"id": "idpf_xxxxxxxxxxxx",
      	"kind": "individual",
      	"last_name": "Rivera",
      	"requested_information": [
      		{
      			"description": "A government-issued photo ID used to confirm your identity.",
      			"error_message": null,
      			"field": "identity_document",
      			"id": "inrqi_xxxxxxxxxxx",
      			"label": "Identity Document",
      			"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>