---
title: "List Verifications"
method: GET
path: "/verifications"
tags: ["Verifications"]
---

# List Verifications

`GET /verifications`

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

## Query parameters

- `account_id` string, required
- `order` 'updated_at' | 'created_at'
- `direction` 'asc' | 'desc'

## Response `200`

OK

- object
  - `data` object[]
    - `address` object, nullable — Address on the verification profile. `null` when no address is set.
      - `city` string, nullable
      - `country` string, nullable — Two-letter ISO 3166-1 country code, for example `US`, `DE`, or `GB`.
      - `line1` string — First line of the street address.
      - `line2` string, nullable — Second line of the street address.
      - `postal_code` string, nullable — Postal or ZIP code.
      - `state` string, nullable — State, province, or region code, for example `CA`.
    - `business_name` string, nullable — Legal business name.
    - `business_structure` string, nullable — 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).
    - `country` string, nullable — Two-letter ISO 3166-1 country code, for example `US`, `DE`, or `GB`.
    - `created_at` string — When the verification profile was created, as an ISO 8601 timestamp.
    - `date_of_birth` string, nullable — Formatted as `YYYY-MM-DD`.
    - `first_name` string, nullable
    - `id` string — Verification profile ID, prefixed `idpf_`.
    - `kind` 'individual' | 'business'
    - `last_name` string, nullable
    - `requested_information` object[] — Fields or documents Whop still needs before review can continue. Submit answers with the Update Verification endpoint.
      - `description` string, nullable — Additional instructions for this requested item, or `null`.
      - `error_message` string, nullable — Reason a previously submitted value was rejected. `null` if no submitted value has been rejected.
      - `field` string — Stable field key, such as `ssn` or `business_description`.
      - `id` string — Requested information item ID, prefixed `inrqi_`. Include this ID when submitting an answer.
      - `label` string — Human-readable label for the field, such as `Social Security Number`.
      - `options` 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.
      - `requested_files` 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.
        - `category` string, nullable — File category to include with the uploaded file so Whop can route the document correctly. `null` for a generic upload.
        - `is_optional` boolean — Whether this slot can be left empty.
        - `kind` string, nullable — Specific document type requested, such as `Bank Statement`. `null` for standard identity and business document uploads.
        - `label` string — Label for this upload slot, such as `Front of ID Document`.
        - `multiple` boolean — Whether this slot accepts more than one file.
      - `type` string, nullable — Input type expected for this item: `text`, `date`, `phone`, `address`, `files`, or `select`.
    - `required_documents` object[] — Documents for a document-upload verification and their progress. Present only on verifications created by sending `documents`. `pending_upload` documents were not accepted yet — send the full set again with another Create Verification call.
      - `document` string — Document slot key, such as `id_card_front`, `id_card_back`, or `selfie`.
      - `rejection_reason` string, nullable — Why the previous submission was rejected, when the provider requested new documents or declined the verification.
      - `status` 'pending_upload' | 'submitted' — `pending_upload` until the document has been relayed for review; `submitted` afterwards.
    - `session_url` string, nullable — Hosted verification session URL for the user to complete identity checks. Expires 7 days after creation.
    - `status` 'not_started' | 'pending' | 'processing' | 'approved' | 'rejected' | 'action_required' — Current verification state. `not_started` before any session has been created; `pending` while a session is in progress and needs the user's input; `processing` while the provider reviews submitted documents — nothing to do but wait; `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.
    - `updated_at` string — When the verification profile was last updated, as an ISO 8601 timestamp.

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-07-14** `3a06a605784b` — 1 warning
  - added the new `processing` enum value to the `data/items/status` response property for the response status `200`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/verifications/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/60bbb4a6ffbc/schema)