---
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[] — What Whop still needs before review can continue — one requirement per entry. Answer with Update Verification; nothing from the response is echoed back. Keys that don't apply are omitted.
      - `errors` object[] — Present after a rejected submission.
        - `code` string — Stable error code.
        - `reason` string — Why it was rejected.
      - `id` string, required — Requested information item ID, prefixed `inrqi_`.
      - `label` string, required — Instruction to show the user. Carries the reviewer's note verbatim when there is one.
      - `optional` boolean — `true` when the item can be skipped.
      - `options` string[] — The values `value` may take on a `select` item. On an `id_document` item these are the ID types accepted, and the chosen one decides which `documents` slots to send. Absent when the item has no choice to make.
      - `requirement` string, required — What is needed: a document name such as `bank_statement`, or a field key such as `ssn` or `identity_document`. Handle unrecognized values by `type`.
      - `type` string, required — What to send as the answer, so you never have to infer it: `files` (a document, as a list of its pages), `id_document` (send `documents` with the slot keys for the ID you are uploading), `text`, `date`, `phone` or `select` (send `value`), or `address` (send `address`).
    - `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' | '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_at` string — When the verification profile was last updated, as an ISO 8601 timestamp.

## Other responses

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

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)