> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# KYBレスポンススキーマ：判定ペイロードのリファレンス

> DiditのKYB判定ペイロードを注釈付きで解説します。法人登記チェック、主要人物、UBOのKYC概要、書類、AMLスクリーニング、共通フィールドを網羅。チェック1件あたり$2.00から。

このページでは、法人確認 (KYB)セッションに対して[`GET /v3/session/{id}/decision/`](https://docs.didit.me/ja/sessions-api/retrieve-session)が返すペイロード全体を説明します。このエンドポイントは共通のもので、企業の`session_id`を渡すと、レスポンスには`session_kind: "business"`と、以下に示す企業固有の機能配列が含まれます。

## トップレベル構造

```json theme={null}
{
  "session_id": "bs_01H...",
  "session_kind": "business",
  "session_number": 89,
  "session_url": "https://verify.didit.me/...",
  "status": "Approved",
  "status_override": null,
  "workflow_id": "wf_kyb_standard",
  "features": ["KYB_REGISTRY", "AML", "KYB_DOCUMENTS", "KYB_KEY_PEOPLE"],
  "vendor_data": "biz-acme-001",
  "metadata": { },
  "callback": null,

  "registry_checks": [ ... ],
  "aml_screenings": [ ... ],
  "document_verifications": [ ... ],
  "key_people_checks": [ ... ],

  "phone_verifications": null,
  "email_verifications": null,
  "questionnaire_responses": null,
  "ip_analyses": null,

  "reviews": [ ],
  "decision_trace": { ... },
  "linked_records": null,
  "contact_details": { ... },
  "expected_details": null,
  "created_at": "...",
  "expires_at": "..."
}
```

各機能の配列は複数のインスタンスを持つことができます。各要素は、グラフ型ワークフロー内の1つのノードを表します。nullは、このセッションのワークフローにその機能が含まれていなかったことを意味します。

## 共通のトップレベルフィールド

| フィールド | 型 | 説明 |
| - | - | - |
| `session_id` | UUID | セッションの一意な識別子 |
| `session_kind` | enum | KYBセッションでは常に`"business"` |
| `session_number` | int | アプリケーション内での連番 |
| `session_url` | URL | ホスト型の認証リンク |
| `status` | enum | セッション全体のステータス（[ステータス](https://docs.didit.me/ja/business-verification/statuses.md)を参照） |
| `status_override` | object or null | プラットフォームが自動で設定するはずのステータスとは異なる`status`を、レビュアーが手動で設定した場合（たとえば、紐づく主要人物の認証が却下されているのに企業を承認した場合）は`{ overridden_at, automatic_status }`。ステータスが自動で設定されたものである場合は`null`。手動による承認と自動による承認を見分けるために使用します |
| `decision_trace` | object | 判定がどのように下されたかを示します。`status`、`decided_by`（`manual`、`automatic`または`investigator`）、`decided_at`、`automatic_status`、`terminal_node_id`、`actor`、`warning_counts`、`status_warnings`（ステータスを決定した警告）を含みます |
| `linked_records` | object or null | セッションに紐づく他のレコードの概要。表示するものがない場合は`null` |
| `workflow_id` | UUID | このセッションで使用されたワークフロー |
| `features` | array of strings | ワークフローが実行した機能の識別子（例：`KYB_REGISTRY`、`AML`、`KYB_DOCUMENTS`、`KYB_KEY_PEOPLE`、`PHONE`、`EMAIL`） |
| `vendor_data` | string | 企業に対してお客様が付与した識別子 |
| `metadata` | object | セッション作成時に付与した任意のJSON |
| `callback` | URL or null | 認証完了後のリダイレクト先URL（任意） |
| `contact_details` | object or null | `{ email, email_lang, send_notification_emails, phone }`。フローにメールまたは電話による通知が含まれる場合に設定されます |
| `expected_details` | object or null | セッション作成時に渡した、企業の想定データのペイロード。`company_name`、`registry_country`（`XX`、または州レベルの法人登記の場合は州を含めた`XX-YY`。例：`US-CA`）、`registration_number` |
| `reviews` | array | セッションに対するレビュアーの最新のメモ |
| `created_at`, `expires_at` | ISO timestamps | - |

## `registry_checks[]`

各項目は1件の法人登記チェックです(通常はセッション1件あたり1件ですが、再帰的な法人UBOのKYBを行うグラフワークフローでは複数になります)。

```json theme={null}
{
  "status": "Approved",
  "node_id": "feature_kyb_registry",
  "data_resolved": true,
  "company": { ...see below... },
  "ownership_structure": { },
  "warnings": []
}
```

| フィールド | 説明 |
| - | - |
| `status` | 機能のライフサイクルステータス(`Approved`、`Declined`、`In Review`、`Not Finished`、`Resub Requested`) |
| `node_id` | このチェックのグラフノード識別子 |
| `data_resolved` | 登記データの読み込みが完了した場合、またはユーザーがデータを手動で入力した場合に`true` |
| `company` | 登記の完全なペイロード。下記の**`company`ブロック**を参照してください |
| `ownership_structure` | 所有構造レベルが配信されたときに登記が証明した資本構成表です。`shareholders[]`と`beneficial_owners[]`からなり、それぞれ`company.beneficial_owners[]`と同じ登記上の身元情報と持分(`name`、`entity_type`、`roles`、`ownership_min_shares` / `ownership_max_shares`、...)、および正規の`shareholding`を持ちます。登記が所有構造を証明しなかった場合は`null`です。現在の記録は`company.beneficial_owners`と`company.ownership`を参照してください |
| `warnings` | この登記チェックを対象とする構造化された警告・ログエントリ。[法人確認の警告](https://docs.didit.me/ja/business-verification/warnings.md)を参照してください。 |

### `company`ブロック

ネストされたcompanyオブジェクトは、登記から導出された(必要に応じてユーザーが編集した)法人の全体像です。

```json theme={null}
{
  "uuid": "...",
  "node_id": "feature_kyb_registry",
  "status": "Approved",
  "registry_status": "active",
  "data_resolved": true,
  "company_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "company_type": "Private Limited",
  "incorporation_date": "2010-05-14",
  "registered_address": "1 Main Street, London EC1A 1AA, United Kingdom",
  "tax_number": "SAMPLE-TAX-12345",
  "risk_level": null,
  "verification_status": "verified",
  "is_from_registry": true,
  "fetch_status": "resolved",
  "alternative_names": "Acme Ltd",
  "nature_of_business": "Software publishing",
  "registered_capital": "100000 GBP",
  "website": "https://acme.example",
  "email": "alex.sample@example.com",
  "phone": "+15550101000",
  "legal_entity_identifier": "529900XXXXXXXXXXXXX",
  "location_of_registration": "London",
  "vat_number": "GB980780684",
  "vat_validation_status": "format_valid",
  "vat_validated_number": "GB980780684",
  "vat_validation_source": "format_rules",
  "vat_validated_name": null,
  "vat_validated_address": null,
  "vat_checked_at": "2026-04-16T10:10:00Z",
  "financial_summary": { },
  "officers": [ ... ],
  "beneficial_owners": [ ... ],
  "addresses": [
    {
      "type": "registered",
      "address": "1 Main Street, London EC1A 1AA, United Kingdom",
      "street": "1 Main Street",
      "city": "London",
      "postal_code": "EC1A 1AA",
      "region": null,
      "country_code": "GB",
      "description": null
    }
  ],
  "industries": [
    { "code": "58290", "description": "Other software publishing", "scheme": "UK SIC 2007", "is_primary": true }
  ],
  "accounts": { ... },
  "ownership": {
    "status": "delivered",
    "tier_requested": "ubo",
    "tier_delivered": "ubo",
    "unavailable_reason": null,
    "direct_ownership_complete": true,
    "unresolved": []
  },
  "registry_tier": "ubo",
  "registry_tier_delivered": "ubo",
  "registry_ownership_status": "delivered",
  "registry_monitoring": null,
  "registry_data": { },
  "user_provided_data": { },
  "confirmed_by_user_at": "2026-04-16T10:10:00Z",
  "last_console_edit_at": null,
  "is_editable": false
}
```

| フィールド | 説明 |
| - | - |
| `registry_status` | プロバイダーが報告したステータス(`active`、`dissolved`、`struck_off`、`inactive`など)。[ステータス](https://docs.didit.me/ja/business-verification/statuses.md#登記ステータス-プロバイダー提供)を参照してください |
| `is_from_registry` | 公式登記からデータを取得した場合は`true`、手動入力の場合は`false` |
| `fetch_status` | `pending`、`resolved`、`failed`のいずれかで、登記照会の状態を示します |
| `verification_status` | `verified`、`failed`、`unknown`のいずれか |
| `risk_level` | 登記ソースからそのまま渡される任意の値です。通常は`null`です。Diditはリスクレベルを算出しないため、判断には`warnings[]`とセッションの`status`を使用してください |
| `registry_monitoring` | 当該企業の最新の登記モニター。存在しない場合は`null`です。[登記モニタリング](https://docs.didit.me/ja/business-verification/ownership.md#株主とuboのモニタリング)が利用可能になった時点でのみ値が入ります。フィールド:`uuid`、`status`、`unavailable_reason`、`enrolled_at`、`cancelled_at`、`last_bill_date`、`next_bill_date`、`last_event_at`、`events_count`、`watched_fields` |
| `is_editable` | 登記由来のデータをエンドユーザーがまだ編集できる間は`true` |
| `registry_data` | Diditが正規化した登記の詳細です。所有構造の結果(`ownership_error`、`section_errors`、`ubo_resolution`)、[update-data](https://docs.didit.me/ja/sessions-api/update-data.md)で行った修正、専用のフィールドを持たない登記上の事実が含まれます。登記ソース自体の記録が含まれることはありません。キーは企業によって異なり、安定した契約ではないため、代わりに正規のフィールドを参照してください |
| `user_provided_data` | エンドユーザーが入力または編集したフィールド(登記の値との差分を監査する際に役立ちます) |
| `confirmed_by_user_at` | エンドユーザーが登記データを確認・編集した日時のタイムスタンプ |
| `vat_number` | 収集した場合の、提出されたとおりのVAT番号 |
| `vat_validation_status` | VAT番号(ない場合は`tax_number`)の検証結果。`valid`、`invalid`、`format_valid`、`invalid_format`、`could_not_validate`、`not_applicable`のいずれかです。[VATおよび納税者番号の検証](https://docs.didit.me/ja/business-verification/company-data.md#vatおよび納税者番号の検証)を参照してください |
| `vat_validated_number` / `vat_validation_source` | ソースが把握している形式での照合対象の番号と、ステータスを判定したソース(公式登記、または`format_rules`) |
| `vat_validated_name` / `vat_validated_address` | ソースが開示している場合の、ソースに登録された名称と住所 |
| `vat_checked_at` | 照合のタイムスタンプ。照合が実行されなかった場合は`null` |
| `officers[]` | KYCエンリッチメントが組み込まれた役員(下記参照) |
| `beneficial_owners[]` | KYCエンリッチメントが組み込まれたUBO(下記参照) |
| `addresses[]` | 登記に記載されたすべての住所で、下記の正規の住所形式で表されます。記載がない場合は`null` |
| `industries[]` | 登記が当該企業を分類している事業活動で、下記の正規の業種形式で表されます。記載がない場合は`null` |
| `accounts` | 報告されている場合の法人の届出日:`last_annual_return_date`と`last_agm_date`。これらは届出と総会に関するもので、財務諸表を示すものではありません |
| `ownership` | 所有構造(株主 / UBO)レベルの結果で、下記の正規の形式で表されます |
| `registry_tier` / `registry_tier_delivered` / `registry_ownership_status` | 注文したレベル、配信された(請求対象の)レベル、所有構造の結果。同じ値が`ownership`にも含まれます |

### すべての国と登記ソースで共通の形式

Diditは複数の登記ソースを通じて、多くの国の法人登記を読み取ります。
各ソースは独自のレイアウトで公開していますが、`company`ブロックは常に同じ形式です。企業データの取得元である国やソースにかかわらず、以下のキーは常に同じ型で存在します。
登記が公開していない事実は`null`になるため、国ごとに分岐したり`registry_data`を解析したりする必要はありません。
同じ形式が[判定](https://docs.didit.me/ja/sessions-api/retrieve-session.md)、スタンドアロンの[KYB登記](https://docs.didit.me/ja/standalone-apis/kyb-registry-ubo.md)エンドポイント、ホスト型検証フローから返されます。

**住所**(`addresses`の各項目)

| フィールド | 説明 |
| - | - |
| `type` | 小文字です。登録事務所は`registered`、その他の種類は登記での名称のままです(例:`postal`、`office`)。登記が住所の種類を示していない場合は`null` |
| `address` | 1行にまとめた完全な住所。常に存在します |
| `street`、`city`、`postal_code`、`region` | 登記が公開している場合の、要素ごとに分割された住所 |
| `country_code` | ISO 3166-1 alpha-2 |
| `description` | 登記が付与している場合の、登記独自の住所ラベル |

**業種**(`industries`の各項目)

| フィールド | 説明 |
| - | - |
| `code` | 登記に記載されたとおりの事業活動コード |
| `description` | 登記が公開している場合の事業活動ラベル |
| `scheme` | 分類体系です。どのソースが報告したかにかかわらず、体系ごとに1つの名称を使用します(`UK SIC 2007`、`US SIC`、`NACE Rev. 2`、`NACE Rev. 2.1`、`NAF Rev. 2`、`CNAE`、`SBI`、`NOGA 2008`、`CAE Rev. 4`、`Canada SIC 1977`)。その他の国の体系は登記での名称のままです。登記が名称を示していない場合は`null` |
| `is_primary` | 主たる事業活動の場合は`true`。主たるものとされるエントリーは必ず1件のみです |

登記に事業活動が記載されているものの事業内容の説明がない場合、`nature_of_business`には事業活動のラベルが入力されます。
連絡先情報と別名は取得できる場合に入力されますが、ユーザーまたはレビュアーによる明示的な編集が常に優先されます。

**所有構造** (`ownership`)

| フィールド | 説明 |
| - | - |
| `status` | `delivered`。所有構造の登記機関が応答したもののこの企業がまったく掲載されておらず、提供できる所有構造の記録がない場合は`not_held`。その他の理由でデータが提供されなかった場合（所有者の記載がない記録、所有構造セクションが返されなかった、またはベンダーに照会できなかった場合）は`unavailable`。登記機関が所有構造セクションをまだ取得中の場合は`pending`。Basicレベルの場合は`not_requested` |
| `tier_requested` / `tier_delivered` | `basic`、`shareholders`、または`ubo`。UBOのリクエストに対して直接の株主のみが返された場合は、`shareholders`として提供・請求されます |
| `unavailable_reason` | リクエストされた所有構造レベルが提供されなかった理由：`no_owners_on_record`、`no_natural_person_owner`、`ownership_section_unavailable`、`company_not_found`、`ambiguous_company_match`、`missing_registration_number`、`entity_type_not_covered`、`provider_unavailable`、または`other`。所有構造が提供された場合は`null` |
| `direct_ownership_complete` | 直接の株主の記載上の持分の合計が100%になる場合（丸めによる1パーセントポイント以内の差を含む）は`true`、ならない場合は`false`、所有構造が提供されなかった場合または持分が記載されていない場合は`null` |
| `unresolved[]` | 登記機関が解決できなかった所有構造の連鎖の部分で、`{ reason, section }`の形式です（例：`group_structure`に対する`no_group_structure_on_record`は、直接の所有者は判明しているものの、その上位の企業グループが記録にないことを示します） |

**登記詳細** (`registry_data`)

登記チェックに関するDidit独自の詳細情報であり、登記ソースの記録そのものではありません。
すべてのキーは任意で、企業にその値がある場合にのみ含まれます。また、新しいキーが追加される場合があります。上記の正規フィールドで扱われる項目については、正規フィールドを参照してください。

| フィールド | 説明 |
| - | - |
| 登記情報（`legal_address`、`registered_address`、`registration_date`、`dissolution_date`、`registry_status`、`verification_status`、`company_type`、および[update-data](https://docs.didit.me/ja/sessions-api/update-data.md)が受け付けるその他のフィールド） | 文字列。update-dataで行われた修正、および専用のフィールドを持たない登記上の記載事項（`registration_date`、`dissolution_date`） |
| `ownership_error` | リクエストされた所有構造レベルが提供されなかった理由で、`ownership.unavailable_reason`と同じコードを使用します（`no_owners_on_record`、`ownership_section_unavailable`、`company_not_found`、`provider_unavailable`、`other`など） |
| `section_errors` | 登記機関が返さなかったセクションで、セクション（`officers`、`shareholders`、`group_structure`）をキーとし、それぞれ`{ status_code }`の形式です |
| `ubo_resolution` | UBOレベルが所有構造の連鎖をどのようにたどったか：`parent_chain[]`と`subsidiaries[]`は`{ name, country_code, registration_number }`の形式、`unresolved[]`は`{ reason, section }`の形式です |
| `lite_enrichment` | その国の別の登記ソースが補完した、空欄だったLiteフィールド：`{ fields[], people_added }` |
| `registry_metadata`、`registry_sources[]`、`previous_names[]`、`parent_companies[]`、`documents_available` | 旧形式の登記記録のみ：登記機関独自のフィールド、参照した公式登記簿（`{ name, source_type }`、名前が示されるのは公式登記簿のみ）、旧商号、親会社名、および取得可能な提出書類の数 |

### 役員アイテムの構造(`company.officers`内)

```json theme={null}
{
  "uuid": "...",
  "name": "Jane Doe",
  "first_name": "Jane",
  "last_name": "Doe",
  "date_of_birth": null,
  "date_of_birth_year": 1983,
  "date_of_birth_month": 2,
  "address": "1 Example Street, London",
  "appointment_date": "2024-07-01",
  "termination_date": null,
  "designation": "Director",
  "role": "director",
  "nationality": "USA",
  "is_active": true,
  "kyc_status": "Approved",
  "kyc_session_url": "https://verify.didit.me/..."
}
```

`date_of_birth`は、登記機関が完全な日付を提供する場合にのみ入力されます。
登記機関が年のみ、または年月のみを報告する場合は、`date_of_birth_year`と`date_of_birth_month`を使用してください。欠けている日が推測されることはありません。
氏名、生年月日の情報、住所、就任日は、企業の役員リストと主要人物の登記リストの両方で引き続き利用できます。

### 実質的支配者アイテムの構造(`company.beneficial_owners`内)

```json theme={null}
{
  "uuid": "...",
  "name": "John Doe",
  "first_name": "John",
  "last_name": "Doe",
  "entity_type": "person",
  "date_of_birth": null,
  "country_of_birth": null,
  "email": null,
  "company_name": null,
  "registration_number": null,
  "nationality": null,
  "designation": null,
  "appointment_date": null,
  "voting_min_shares": null,
  "voting_max_shares": null,
  "roles": ["ubo"],
  "ownership_min_shares": "40",
  "ownership_max_shares": "40",
  "is_active": true,
  "kyc_status": "Pending",
  "kyc_session_url": "https://verify.didit.me/...",
  "effective_ownership_percent": 40.0,
  "shareholding": {
    "share_class": "Ordinary",
    "number_of_shares": 40,
    "currency": "GBP",
    "nominal_value": 1,
    "total_value": null,
    "percentage": 40
  }
}
```

`kyc_status`はB2C向けに安全な形に変換した値を使用します：`Approved`、`Declined`、または`Pending`（KYCが完了するまで、詳細なセッション状態はすべて`Pending`にまとめられます）。

`shareholding`は所有者の保有内容を、すべての国と登記ソースで同じ形式で示します：`share_class`、`number_of_shares`、`currency`、`nominal_value`、`total_value`、`percentage`（正確な持分、小数点以下4桁）。
登記機関が保有内容を記載していない場合は`null`です。
英国のPSCの25-50%のような範囲は持分ではありません。`percentage`は`null`となり、範囲は`ownership_min_shares` / `ownership_max_shares`に保持されます。
株主とUBOはどちらも`beneficial_owners`に掲載され、`roles`で区別されます。

## `key_people_checks[]`

これは、セッション内のすべての役員とUBOを対象とした**集約チェック**です。2つのバケットを公開するため、コンソールで「法人登記から抽出」と「企業が提出した情報」を並べて表示できます。さらに、UBOのKYCの概要も含まれます。

```json theme={null}
{
  "status": "Approved",
  "node_id": "feature_kyb_key_people",
  "registry": {
    "officers": [ ...registry-derived officers... ],
    "beneficial_owners": [ ...registry-derived UBOs... ]
  },
  "submitted": {
    "parties": [ ...user-submitted key-people records... ]
  },
  "ubo_kyc_summary": {
    "total": 2,
    "approved": 1,
    "flagged": 0,
    "pending": 1
  },
  "warnings": []
}
```

* **`registry.officers` / `registry.beneficial_owners`**：法人登記チェックで抽出された関係者。
* **`submitted.parties`**：企業の管理者が主要人物フローで明示的に追加した関係者（`source = "USER"`のレコード）。

### `registry.officers[]` / `registry.beneficial_owners[]`

法人登記の情報は、前述の`company.officers` / `company.beneficial_owners`と一致します。
主要人物ではさらに、AMLステータスと、`kyc_session_id`や認証ワークフローのフィールドなどの詳細な認証の紐付けが含まれます。
企業の一覧は、従来の簡略化されたKYCステータスと認証URLをそのまま保持します。

### `submitted.parties[]`

ユーザーが提出した関係者には、KYCまたは子KYBへの紐付けが含まれます：

```json theme={null}
{
  "uuid": "...",
  "entity_type": "person",
  "name": "Alice Chen",
  "first_name": "John",
  "last_name": "Doe",
  "email": "alex.sample@example.com",
  "role": "ubo",
  "ownership_percent": 35.0,
  "nationality": "USA",
  "position": "CEO",
  "date_of_birth": "1990-01-01",
  "phone_number": "+34612345678",
  "source": "USER",
  "requires_verification": true,
  "is_skipped": false,
  "kyc_session_id": "sess-xyz...",
  "kyc_session_status": "Not Started",
  "kyc_session_url": "https://verify.didit.me/...",
  "kyc_session_deleted": false,
  "custom_fields": { }
}
```

法人の関係者（`entity_type: "company"`）にはさらに`company_name`と`registration_number`が含まれ、法人UBOに対してネストされたKYBが有効な場合は`kyb_sub_session_id` / `kyb_sub_session_status` / `kyb_sub_session_deleted`も含まれます。

`kyc_session_deleted`（および法人向けの`kyb_sub_session_deleted`）は、関係者の子セッションが削除された場合に`true`になります。削除された子セッションは削除時点のステータスを保持し、決して確定しないため、ステータスではなくこのフラグを参照してください。リンクが解決できなくなるため対応する`*_session_url`は`null`として返され、主要人物チェックは無期限に待機するのではなく`In Review`になります。子セッションの削除が合格とみなされることはありません。KYBを確定させるには、[`PATCH /v3/session/{id}/kyb/parties/{party_uuid}/`](https://docs.didit.me/ja/sessions-api/update-data#主要人物の当事者をスキップ)で関係者を免除してください。

### `ubo_kyc_summary`

UBOのKYC進捗の集計です。ダッシュボードのカード1枚に表示するのに便利です：

| フィールド | 意味 |
| - | - |
| `total` | KYCセッションが紐付けられた有効なUBOの数 |
| `approved` | KYCセッションが`Approved`のUBO |
| `flagged` | KYCセッションが`Declined`または`In Review`のUBO |
| `pending` | それ以外のすべて（未完了） |

KYCセッションが紐付けられたUBOがない場合は`null`を返します。

## `document_verifications[]`

ノードごとにグループ化された書類：

```json theme={null}
{
  "status": "Approved",
  "node_id": "feature_kyb_documents",
  "items": [
    {
      "uuid": "...",
      "document_type": "LEGAL_PRESENCE",
      "document_subtype": "CERTIFICATE_OF_INCORPORATION",
      "document_group": "LEGAL_PRESENCE",
      "status": "Approved",
      "file_url": "https://didit-storage.s3...",
      "document_metadata": {
        "file_size": 246810,
        "content_type": "application/pdf",
        "creation_date": "2024-05-15",
        "modified_date": "2024-05-15",
        "overlay_manipulation": null
      },
      "ocr_data": {
        "company_name": "Acme Corporation Limited",
        "registration_number": "12345678",
        "incorporation_date": "2010-05-14"
      }
    }
  ],
  "groups": {
    "LEGAL_PRESENCE": { "total": 1, "approved": 1, "pending": 0, "declined": 0, "in_review": 0, "other": 0, "missing": 0 },
    "OWNERSHIP_STRUCTURE": { "total": 1, "approved": 1, "pending": 0, "declined": 0, "in_review": 0, "other": 0, "missing": 0 }
  },
  "required_groups": ["LEGAL_PRESENCE", "OWNERSHIP_STRUCTURE"],
  "warnings": []
}
```

| フィールド | 説明 |
| - | - |
| `items[]` | 個別の書類エントリ。それぞれに`status`、`document_type`と`document_group`（グループ）、`document_subtype`、`file_url`（署名付きURL）、`document_metadata`、OCR抽出結果が含まれます |
| `groups` | グループごとの進捗カウンター。グループの値（`LEGAL_PRESENCE`、`COMPANY_DETAILS`、`OWNERSHIP_STRUCTURE`、`REPRESENTATIVES_AUTHORIZATION`、および未分類の書類用の`OTHER`）をキーとします。各グループには`total`、`approved`、`pending`、`declined`、`in_review`、`other`、`missing`が含まれます。[KYB書類グループ](https://docs.didit.me/ja/business-verification/documents.md#書類グループ)を参照してください |
| `required_groups` | ワークフローで必須に指定されたグループ。すべてが満たされた場合にのみセッションを承認するようにしてください |

### 法人書類のメタデータ

PDFの法人書類では、`items[].document_metadata.overlay_manipulation`に、オーバーレイテキストの編集が疑われる場合のフォレンジック証拠が含まれることがあります。存在する場合、次の内容が含まれます：

| フィールド | 説明 |
| - | - |
| `detected` | オーバーレイテキストの改ざんの証拠が検出されたかどうか |
| `analyzed` | PDFを解析できたかどうか |
| `signals` | 検出されたフォレンジックシグナル（`duplicate_font_subset`や`glyph_fragmentation`など） |
| `manipulated_regions` | 編集が疑われるテキストを囲む、PDFページ座標の矩形：`page`、`x`、`y`、`width`、`height`、`page_width`、`page_height` |

オーバーレイの証拠が見つからなかった場合、書類がPDFでない場合、またはPDFを解析できなかった場合、このフィールドは`null`になります。

## `aml_screenings[]`

企業レベル、および（ワークフローで設定されている場合）個人レベルのAMLスクリーニングです。

```json theme={null}
{
  "node_id": "feature_aml",
  "status": "Approved",
  "total_hits": 0,
  "score": 0,
  "entity_type": "COMPANY",
  "screened_data": {
    "company_name": "Acme Corporation Limited",
    "country_code": "GBR"
  },
  "is_ongoing_monitoring_enabled": true,
  "next_ongoing_monitoring_bill_date": "2027-04-16",
  "last_ongoing_screening_at": "2026-09-12T04:03:11Z",
  "last_ongoing_screening_datasets_updated_at": null,
  "hits": [],
  "warnings": []
}
```

`total_hits > 0`の場合、各ヒットには一致スコア、リスクスコア、ウォッチリストの情報源、およびupdate-aml-hit-statusエンドポイントで更新できるヒットごとの`review_status`が含まれます。ヒットの構造については[AMLスクリーニングレポート](https://docs.didit.me/ja/core-technology/aml-screening/report-aml-screening.md)を参照してください。

## 共通の機能配列

`phone_verifications`、`email_verifications`、`questionnaire_responses`、`ip_analyses`は、ユーザー（KYC）セッションと同じ項目ごとの形式を使用します。ワークフローに含まれていない場合は`null`になります。項目のスキーマについては[KYCレスポンス](https://docs.didit.me/ja/sessions-api/retrieve-session.md)を参照してください。

`signatures`は、ワークフローに[電子署名](https://docs.didit.me/ja/core-technology/electronic-signature/overview.md)ステップがある場合に含まれます。企業セッションでは、企業を代表して署名する主要人物ごとに1つの項目があり、`signer.capacity: "company"`、企業名、主要人物の役割が含まれます。[電子署名レポート](https://docs.didit.me/ja/core-technology/electronic-signature/report-electronic-signature.md)を参照してください。

## 警告の機能グループ

法人確認の警告は、それを生成した機能ごとにグループ化されます：

* `KYB_REGISTRY`：法人登記の利用可否、所有構造、企業活動、国の制限に関する問題。
* `KYB_DOCUMENTS`：法人書類の抽出、照合、メタデータ、改ざん、サブタイプ、書類の古さ、試行回数の上限に関する問題。
* `AML`：企業のAMLスクリーニングでの一致、またはスクリーニングデータの欠落。
* `KYB_KEY_PEOPLE`：取締役、役員、UBO、代表者に関連する個人レベルの問題。
* `PHONE`：電話番号のリスク、重複、ブロックリスト、認証コードの試行に関する問題。
* `EMAIL`：メールアドレスのリスク、到達性、重複、ブロックリスト、認証コードの試行に関する問題。
* `QUESTIONNAIRE`：アンケートの回答に基づくカスタムステータスルール。
* `LOCATION`：デバイス・IP分析、プライベートネットワーク、IPブロックリスト、デバイスブロックリスト、デバイス/IPの重複に関する問題。
* `SIGNATURE`：電子署名の拒否、コード確認の失敗、署名者名の不一致、未認証の署名者、書類の変更、フィールドデータの欠落。[電子署名の警告](https://docs.didit.me/ja/core-technology/electronic-signature/warnings-electronic-signature.md)を参照してください。

警告コードの一覧については[法人確認の警告](https://docs.didit.me/ja/business-verification/warnings.md)を参照してください。

## ワークフローによるフィールドのフィルタリング

ワークフローでは、`response_attributes`を使って各機能項目に含まれるネストされたフィールドを制限できます。設定にかかわらず常に含まれるフィールドは`status`、`warnings`、`node_id`です。それ以外のフィールドは、許可リストに含まれていない場合はnullに設定されます。スキーマの安定性を保つため、キー自体はレスポンスに残ります。

## 次のステップ

> [card] [ステータス](https://docs.didit.me/ja/business-verification/statuses.md)
>
> 各ステータス値の意味。

> [card] [リスク評価](https://docs.didit.me/ja/business-verification/risk-assessment.md)
>
> KYBの結果を左右する要因。

> [card] [AMLレポート](https://docs.didit.me/ja/core-technology/aml-screening/report-aml-screening.md)
>
> AMLヒットの完全なペイロードリファレンス。

> [card] [主要人物](https://docs.didit.me/ja/business-verification/key-people.md)
>
> 関係者が法人登記またはユーザーによる提出から、それぞれ `registry` / `submitted` バケットにどのように振り分けられるか。

> [card] [書類](https://docs.didit.me/ja/business-verification/documents.md)
>
> 書類グループ、OCR、相互照合。

> [card] [セッションの取得](https://docs.didit.me/ja/sessions-api/retrieve-session.md)
>
> レスポンス例を含むエンドポイントの完全なリファレンス。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.