---
title: "List KYB Verification Regions"
method: GET
path: "/v1alpha2/kybVerificationRegions"
tags: ["ClientService"]
---

# List KYB Verification Regions

`GET /v1alpha2/kybVerificationRegions`

## Request

- Base URL: `https://api.thirdfort.dev/client/api`
- URL: `https://api.thirdfort.dev/client/api/v1alpha2/kybVerificationRegions`
- Auth: HTTP bearer

Lists the company documents and other KYB-specific data for each jurisdiction and state that supports KYB verification, with jurisdiction-specific document names. The catalog changes only on release; cache the response for up to 24 hours. An INVALID_ARGUMENT for an unavailable document type on CreateCheck means the cached catalog is stale.

## Response `200`

A successful response.

- ListKYBVerificationRegionsResponse: Response message for [ClientService.ListKYBVerificationRegions](#/operations/ClientService_ListKYBVerificationRegions).
  - `kybVerificationRegions` KYBVerificationRegion[]: One entry per KYB_VERIFICATION-capable jurisdiction and state pair, including pairs with no orderable documents. The catalog is small, so pagination is not needed.
    - `name` string: The resource name of the region. The ID is the lowercase jurisdiction code, followed by "-" and the lowercase subdivision code where one is required. Format: `kybVerificationRegions/{kyb_verification_region}`, e.g. `kybVerificationRegions/gb`, `kybVerificationRegions/us-ca`.
    - `region` Region: A jurisdiction, qualified by a subdivision where a capability requires one.
      - `jurisdiction` string, required: Required. The jurisdiction code, matching Jurisdiction.code.
      - `state` string: The subdivision code, matching Jurisdiction.Subdivision.code. Set only where the capability requires a subdivision.
    - `documentTypes` CompanyDocumentType[]: The orderable documents. Empty when none can be ordered for this jurisdiction and state.
      - `type` 'DOCUMENT_TYPE_UNSPECIFIED' | 'REGISTER_EXTRACT' | 'BENEFICIAL_CHECK' | 'SHAREHOLDERS' | 'ANNUAL_ACCOUNTS' | 'ARTICLES_OF_ASSOCIATION' | 'REGISTER_CHECK' | 'REGISTER_REPORT' | 'TRADE_REGISTER' | 'ANNUAL_RETURN' | 'FILED_DOCUMENTS': - REGISTER_EXTRACT: A Register Extract official document - BENEFICIAL_CHECK: A Beneficial Check official document - SHAREHOLDERS: A Shareholders official document - ANNUAL_ACCOUNTS: An Annual Accounts official document - ARTICLES_OF_ASSOCIATION: An Articles of association official document - REGISTER_CHECK: A register check official document - REGISTER_REPORT: A register report official document - TRADE_REGISTER: A trade register official document - ANNUAL_RETURN: An annual return official document - FILED_DOCUMENTS: A filed documents official document
      - `displayName` string: The jurisdiction's name for this document.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/thirdfort/apis/thirdfort-client-api-preview.md) - [All operations](https://skmtc.dev/thirdfort/apis/thirdfort-client-api-preview/llms.txt) - [OpenAPI document](https://skmtc.dev/thirdfort/apis/thirdfort-client-api-preview/revisions/3446b9aefa90?raw)