latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

Verifications

List Verifications

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

get/verifications

Query parameters

account_idstring required

Account or user ID whose verifications you want to list. Use a biz_ account ID, or the caller's user_ ID for personal verifications.

order'updated_at' | 'created_at'

Field used to sort returned verifications.

direction'asc' | 'desc'

Sort direction for returned verifications.

Response

OK

Example response

{
  "data": [
    {
      "address": {
        "city": "Austin",
        "country": "US",
        "line1": "4180 Burnet Rd",
        "line2": "Suite 2",
        "postal_code": "78756",
        "state": "TX"
      },
      "business_name": "Shine Time Auto Detailing, LLC",
      "business_structure": "sole_proprietorship",
      "country": "US",
      "created_at": "2026-06-01T12:00:00.000Z",
      "date_of_birth": "1990-01-01",
      "email": "marcus@shinetime.example",
      "first_name": "Marcus",
      "id": "idpf_xxxxxxxxxxxx",
      "kind": "individual",
      "last_name": "Webb",
      "phone": "+15551234567",
      "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",
          "optional": true,
          "options": [
            "sole_proprietorship"
          ],
          "requirement": "bank_statement",
          "type": "files"
        }
      ],
      "required_documents": [
        {
          "document": "id_card_front",
          "rejection_reason": "Document image was too blurry to read.",
          "status": "submitted"
        }
      ],
      "session_url": "https://sumsub.com/session/abc",
      "status": "action_required",
      "updated_at": "2026-06-02T12:00:00.000Z"
    }
  ]
}