---
title: "Lookup KYB Verification Region"
method: GET
path: "/v1alpha2/kybVerificationRegions:lookup"
tags: ["ClientService"]
---

# Lookup KYB Verification Region

`GET /v1alpha2/kybVerificationRegions:lookup`

## Request

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

Looks up the company documents and other KYB-specific data for one jurisdiction and state, with jurisdiction-specific document names. A region that is not KYB_VERIFICATION-capable returns NOT_FOUND. 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.

## Query parameters

- `region.jurisdiction` string, required
- `region.state` string

## Response `200`

A successful response.

- KYBVerificationRegion: The KYB-specific data for one KYB_VERIFICATION-capable jurisdiction and state.
  - `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)