---
title: "List Verifications"
method: GET
path: "/v2/partners/{partner_id}/kyb"
tags: ["kyb"]
---

# List Verifications

`GET /v2/partners/{partner_id}/kyb`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/partners/{partner_id}/kyb`
- Auth: HTTP bearer

List KYB Verifications

Returns all KYB verifications for the specified partner, newest first.

## Path parameters

- `partner_id` string, required

## Response `200`

Successful Response

- KYBVerificationSummary[]
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `status` 'pending' | 'in_progress' | 'completed' | 'failed', required: Status of a business verification request.
  - `verification_type` 'business_search' | 'online_presence' | 'lien_search' | 'docket_search' | 'comprehensive', required: Type of business verification to perform.
  - `requested_at` string, date-time, required: When the verification was requested.
  - `completed_at` string, date-time, nullable, required: When the verification completed (success or failure).
  - `is_verified` boolean, nullable, required: Overall verification result - True if business is verified, False if not, None if pending.
  - `verification_rating` string, nullable, required: Verification quality rating (A, B, C, F). Null if vendor doesn't provide.
  - `risk_rating` string, nullable, required: Risk assessment rating (A, B, C, F). Null if vendor doesn't provide.
  - `error_message` string, nullable, required: Error message if verification failed.
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)