> ## 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. # 共有セッションインポートAPI：再利用可能なKYC・KYB > DiditのPOST /v3/session/import-shared/で、パートナーの共有トークンを使ってKYCまたはKYBセッションをインポートできます。再検証なしで本人確認を再利用でき、料金は従量課金制です。 共有セッションのインポート用プロンプト プロンプトをクリップボードにコピー \

\`Import a verification session shared by a partner application (Reusable KYC / KYB).

Endpoint:
POST https://verification.didit.me/v3/session/import-shared/

Authentication:
Use the x-api-key header with the receiving application's Didit API key. Privilege: write:sessions.

Request body:
\- share_token (string, required) — JWT minted by the partner via POST /v3/session/{id}/share/. Didit decodes it, reads the embedded session_kind, and clones the matching kind.
\- workflow_id (string, UUID, required) — Workflow in YOUR application to attach the imported session to. KYC token → pass a KYC workflow_id. KYB token → pass a KYB workflow_id.
\- vendor_data (string, optional) — Your stable identifier for the entity. Auto-creates a User or Business entity if it does not already exist.
\- trust_review (boolean, optional, default false) — false → imported session lands in "In Review" so your team can re-review. true → imported session preserves the original status (e.g. "Approved"). Use true only when you fully trust the sharing partner's decision.

curl example:
curl -X POST https://verification.didit.me/v3/session/import-shared/ \
-H "x-api-key: " \
-H "Content-Type: application/json" \
-d '{
"share_token": "",
"workflow_id": "",
"vendor_data": "partner-user-42",
"trust_review": false
}'

Response (201 Created):
\- session_id (UUID) — NEW UUID minted in your application.
\- session_kind ("user" | "business") — same as the original.
\- session_number — fresh sequence in your application.
\- status — original status (if trust_review=true) or "In Review" (if trust_review=false).
\- shared_from_session — pointer to the original session in the source application.
\- vendor_data, workflow_id — what you sent.
\- All cloned feature arrays: KYC tokens clone id_verifications + liveness_checks + face_matches + face + AML + location + POA + phone + email + database_validations + logs; KYB tokens clone registry_checks + key_people_checks + document_verifications + AML + phone + email + location + questionnaire + logs.

Backward compatibility:
Tokens minted before the unified-sharing rollout (no session_kind field) default to "user" when decoded.

Idempotency:
Importing the same share_token twice into the same application is rejected with 403, for user and business sessions alike.

Failure modes:
\- 400 - { "share_token": ["Invalid share token."] } when the token is malformed or was not issued by Didit.
\- 400 - { "share_token": ["Share token has expired."] } when its exp has passed.
\- 400 - { "share_token": ["This token is not valid for this application."] } when the token was issued for another application.
\- 400 - { "share_token": ["Original session does not exist."] } when the shared session was deleted.
\- 403 - { "detail": "This session has already been shared with your application." } when the session was already imported into this application.
\- 404 - { "detail": "Workflow does not exist for this application." } when workflow_id is not a workflow of your application.

When to call:
\- Cross-organization Reusable KYC (bank → fintech, marketplace → payment provider, etc.).
\- Promoting a verified user from your sandbox application to your production application.
\- Group-company sharing across sibling applications.

After import:
\- The new session works like any other session — fetch with GET /v3/session/{session_id}/decision/ (see /sessions-api/retrieve-session) and react to status / data webhooks.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
貼り付け先 ## KYCとKYBへの対応Diditは共有トークンをデコードし、埋め込まれた`session_kind`を読み取って、対応する種類のセッションを複製します。- `session_kind: "user"`:ユーザーセッションと、それに関連する本人情報、顔、ライブネス、顔照合、AML、位置情報、POA、電話番号、メールアドレス、データベース検証、ログの各行を複製します。 - `session_kind: "business"`:企業セッションと、それに関連する法人登記チェック、主要人物の記録、書類、AMLスクリーニング、電話番号、メールアドレス、位置情報、アンケート、ログの各行を複製します。トークンが統合共有機能の提供開始より前に発行されたもので`session_kind`フィールドを持たない場合、Diditは後方互換性のためにデフォルトで`"user"`として扱います。## 作成されるもの- お使いのアプリケーション内に、同じ種類の**新しいセッション**が、新しい`session_id`、`session_number`、`session_url`とともに作成されます。 - 新しいセッションの`shared_from_session`フィールドは、共有元アプリケーションの元のセッションを指します。 - 新しいセッションのステータスは、元のステータス(`trust_review: true`)または`IN_REVIEW`(`trust_review: false`)のいずれかになります。 - `vendor_data`に対応するエンティティ(UserまたはBusiness)が存在しない場合は、新しいエンティティが自動的に作成されます。## 例> [tab] ユーザー認証 (KYC) セッションをインポートする > > ```bash theme={null} > curl -X POST https://verification.didit.me/v3/session/import-shared/ \ > -H "x-api-key: YOUR_API_KEY" \ > -H "Content-Type: application/json" \ > -d '{ > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "workflow_id": "your-kyc-workflow-id", > "vendor_data": "partner-user-42", > "trust_review": false > }' > ``` > > **レスポンス(201 Created):** > > ```json theme={null} > { > "session_id": "new-uuid", > "session_kind": "user", > "shared_from_session": "original-uuid", > "status": "In Review", > "vendor_data": "partner-user-42", > "id_verifications": [...], > "liveness_checks": [...], > "...": "..." > } > ```> [tab] 法人確認 (KYB) セッションをインポートする > > ```bash theme={null} > curl -X POST https://verification.didit.me/v3/session/import-shared/ \ > -H "x-api-key: YOUR_API_KEY" \ > -H "Content-Type: application/json" \ > -d '{ > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "workflow_id": "your-kyb-workflow-id", > "vendor_data": "partner-biz-acme", > "trust_review": true > }' > ``` > > **レスポンス(201 Created):** > > ```json theme={null} > { > "session_id": "new-uuid", > "session_kind": "business", > "shared_from_session": "original-uuid", > "status": "Approved", > "vendor_data": "partner-biz-acme", > "registry_checks": [...], > "key_people_checks": [...], > "document_verifications": [...], > "...": "..." > } > ```## `trust_review`パラメーター| 値 | 効果 | | - | - | | `true` | インポートされたセッションは元のステータス(例:`APPROVED`)を保持します。共有元のパートナーの判定を完全に信頼できる場合に使用します。 | | `false` | インポートされたセッションは`IN_REVIEW`になり、対応する前にチームで再レビューできます。外部パートナーに対する安全なデフォルトです。 |## エラー| ステータス | 理由 | | - | - | | `400` | `share_token`が無効、期限切れ、別のアプリケーション向けに発行されているか、削除されたセッションを指しているかのいずれかです。メッセージは`share_token`キーに含まれます。 | | `403` | このセッションはすでにお使いのアプリケーションにインポートされています。 | | `404` | `workflow_id`がお使いのアプリケーションのワークフローではありません。 |## 冪等性同じ`share_token`を同じアプリケーションに2回インポートすると、ユーザーセッションと企業セッションのどちらの場合も`403`で拒否されます。## 関連情報- [セッションの共有](https://docs.didit.me/ja/sessions-api/share-session/share.md) - [再利用可能なKYCガイド](https://docs.didit.me/ja/core-technology/reusable-kyc/share-kyc-via-api.md) - [セッションの概要](https://docs.didit.me/ja/sessions-api/overview.md) ## OpenAPI ````yaml ja/openapi-25.json POST /v3/session/import-shared/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 本人確認API。x-api-keyヘッダーで認証します。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/import-shared/: post: tags: - Sessions summary: 共有トークンを使用して、認証セッションを自分のアプリケーションに複製する description: >- 共有トークンを使用して、KYCまたはKYBセッションを新しい`session_id`で呼び出し元のアプリケーションに複製します。冪等ではありません。トークンは受信者ごとに1回のみ使用できます。 operationId: post_v3_session_import_shared requestBody: required: true content: application/json: schema: type: object required: - share_token - trust_review - workflow_id properties: share_token: type: string description: >- [`POST /v3/session/{sessionId}/share/`](/sessions-api/share-session)で発行されたJWT共有トークン。 example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... trust_review: type: boolean description: >- `true`の場合、複製されたセッションは元のセッションの最終的な`status`を維持します。`false`の場合は強制的に`In Review`になります。 example: false workflow_id: type: string format: uuid description: 呼び出し元アプリケーション内のワークフローのUUIDです。別のアプリケーションのIDは`404`で拒否されます。 example: 9f9b1234-aaaa-bbbb-cccc-1234567890ab vendor_data: type: string nullable: true description: 複製されたセッションの`vendor_data`を任意で上書きします。 example: user-1 example: share_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... trust_review: false workflow_id: 9f9b1234-aaaa-bbbb-cccc-1234567890ab vendor_data: user-1 responses: '201': description: >- セッションが複製されました。ボディはどちらの種類でもV3の判定ペイロードで、`session_kind`で区別されます。`"user"`（KYC）には`id_verifications`、`liveness_checks`、`aml_screenings`などのリスト形式の機能ブロックが含まれ、`"business"`（KYB）には`registry_checks`や`key_people_checks`などのブロックが含まれます。どちらにも`shared_from_session`（ソースアプリケーションにおける元のセッションの`session_id`）が含まれます。`trust_review: false`の場合、複製されたセッションの`status`は強制的に`In Review`になります。 content: application/json: schema: $ref: '#/components/schemas/SessionDecision' examples: User session imported: summary: 複製されたKYCセッション（省略版。実際には完全なV3判定ペイロード） value: session_id: 11111111-2222-3333-4444-555555555555 session_kind: user shared_from_session: 99999999-8888-7777-6666-555555555555 session_number: 43762 session_url: null status: In Review workflow_id: 9f9b1234-aaaa-bbbb-cccc-1234567890ab vendor_data: user-1 created_at: '2026-05-17T08:42:11Z' expires_at: '2026-05-24T08:42:11Z' Business session imported: summary: 複製されたKYBセッション（省略版。実際には完全なV3 KYB判定ペイロード） value: session_id: 22222222-3333-4444-5555-666666666666 session_kind: business shared_from_session: 88888888-7777-6666-5555-444444444444 session_number: 982 session_url: null status: Approved workflow_id: 9f9b1234-aaaa-bbbb-cccc-1234567890ab vendor_data: company-1 '400': description: 検証エラー（トークンが無効、期限切れ、対象が誤っている、またはすでに存在しないセッションを参照している）。 content: application/json: examples: Invalid Share Token: summary: 無効なJWT value: share_token: - Invalid share token. Expired Share Token: summary: '`exp`を過ぎたトークン' value: share_token: - Share token has expired. Wrong audience: summary: このアプリケーションに紐付けられていないトークン value: share_token: - This token is not valid for this application. Original missing: summary: ソースセッションは削除されました value: share_token: - Original session does not exist. '403': description: >- APIキーがありません（誤った、失効した、または期限切れのキーの場合は`401`）。または、このソースセッションは呼び出し元のアプリケーションにすでにインポートされています（受信側ごとに引き換えは1回のみ）。 content: application/json: examples: Forbidden: summary: アクセス禁止 value: detail: You do not have permission to perform this action. Already imported: summary: このソースはすでに一度インポートされています value: detail: >- This session has already been shared with your application. '404': description: '`workflow_id`が呼び出し元のアプリケーションに属していません。' content: application/json: examples: Workflow not found: summary: 不明なワークフロー value: detail: Workflow does not exist for this application. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST \ https://verification.didit.me/v3/session/import-shared/ \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "share_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "trust_review": false, "workflow_id": "9f9b1234-aaaa-bbbb-cccc-1234567890ab", "vendor_data": "user-1" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.import_shared( share_token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", trust_review=False, workflow_id="9f9b1234-aaaa-bbbb-cccc-1234567890ab", vendor_data="user-1", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.importShared({ share_token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", trust_review: false, workflow_id: "9f9b1234-aaaa-bbbb-cccc-1234567890ab", vendor_data: "user-1", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.ImportShared(ctx, didit.SessionsImportSharedParams{\n\tShareToken: \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n\tTrustReview: false,\n\tWorkflowID: \"9f9b1234-aaaa-bbbb-cccc-1234567890ab\",\n\tVendorData: didit.String(\"user-1\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.SessionsImportSharedParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().importShared(SessionsImportSharedParams.builder() .shareToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...") .trustReview(false) .workflowId("9f9b1234-aaaa-bbbb-cccc-1234567890ab") .vendorData("user-1") .build()); System.out.println(result); - lang: php label: PHP source: |- sessions->importShared([ 'share_token' => 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...', 'trust_review' => false, 'workflow_id' => '9f9b1234-aaaa-bbbb-cccc-1234567890ab', 'vendor_data' => 'user-1', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.import_shared( share_token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", trust_review: false, workflow_id: "9f9b1234-aaaa-bbbb-cccc-1234567890ab", vendor_data: "user-1" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.ImportSharedAsync(new SessionsImportSharedParams { ShareToken = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", TrustReview = false, WorkflowId = "9f9b1234-aaaa-bbbb-cccc-1234567890ab", VendorData = "user-1", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: SessionDecision: type: object properties: session_id: type: string format: uuid description: セッションの一意の識別子。 session_kind: type: string enum: - user - business description: >- このセッションがユーザー認証（KYC）か法人確認（KYB）かを示す識別子です。`user`の場合、KYC機能の配列（`id_verifications`、`nfc_verifications`、`liveness_checks`、`face_matches`、`poa_verifications`、`document_ai_documents`、`database_validations`など）が適用され、企業向けの配列は含まれません。`business`の場合、ペイロードには代わりに`registry_checks`、`document_verifications`、`key_people_checks`と共有の配列（`aml_screenings`、`phone_verifications`、`email_verifications`、`ip_analyses`、`questionnaire_responses`）が含まれます。**`include=events`を渡した場合は省略されます**。eventsの形式はユーザーセッションにのみ存在するため、そのバリアントではこの識別子が除外されます。 shared_from_session: type: string format: uuid nullable: true description: >- `POST /v3/session/import-shared/`で複製されたセッションの場合：ソースアプリケーションにある元のセッションの`session_id`。その他のセッションではすべて`null`です。`include=events`を渡した場合は省略されます。 shared_from_session_number: type: integer nullable: true description: >- このセッションが組織内の別のアプリケーションからインポートされた場合は、インポート元セッションの`session_number`です。それ以外の場合は`null`です。 session_number: type: integer description: セッションの番号。 nullable: true session_url: type: string format: uri description: セッションのURLです。 nullable: true status: type: string enum: - Not Started - In Progress - Awaiting User - In Review - Approved - Declined - Resubmitted - Expired - Kyc Expired - Abandoned description: >- セッション全体のライフサイクルステータス。ワークフローの結果を集約したものです。終了状態の値は`Approved`、`Declined`、`In Review`、`Expired`、`Kyc Expired`、`Abandoned`です。`Not Started`、`In Progress`、`Awaiting User`、`Resubmitted`は、セッションがまだワークフローを進行中であることを示します。 status_override: type: object nullable: true description: >- レビュアーが`status`を手動で設定した場合に含まれます。ステータスが自動で設定されたものである場合は`null`です。手動承認と自動承認を区別するために使用します。 properties: overridden_at: type: string format: date-time nullable: true automatic_status: type: string nullable: true description: プラットフォーム自身のチェックが結論付けたステータス。 decision_trace: type: object description: ステータスがどのように決まったかを示します。誰が設定したか、どの警告によって設定されたかがわかります。 properties: status: type: string description: セッションのステータス。 decided_by: type: string nullable: true enum: - manual - automatic - investigator - null description: ステータスを設定した者です。セッションの判定が出ていない間は`null`です。 decided_at: type: string format: date-time nullable: true automatic_status: type: string nullable: true description: プラットフォーム自身のチェックによる結論です。手動判定の後は`status`と異なります。 terminal_node_id: type: string nullable: true description: セッションを終了させたワークフローのステータスノード(該当する場合)。 actor: type: object nullable: true description: 手動判定を行ったレビュアーです。 properties: user: type: string nullable: true actor_type: type: string nullable: true warning_counts: type: object description: '`log_type`（`error`、`warning`、`information`）ごとの警告数と`total`。' additionalProperties: type: integer status_warnings: type: array description: '`Declined`または`In Review`のステータスを設定した警告。' items: type: object properties: risk: type: string feature: type: string nullable: true node_id: type: string nullable: true log_type: type: string nullable: true check_status: type: string nullable: true source: type: string description: '警告の発生元となったペイロードのリスト（例: `id_verifications`）。' short_description: type: string nullable: true linked_records: type: object nullable: true description: >- セッションに関連付けられたその他のレコードの概要。表示するものがない場合、および年齢保証基準を宣言しているワークフローでは`null`です。 properties: same_face: type: object nullable: true description: このセッションのいずれかの顔検索で顔が一致した他の人物です。 properties: count: type: integer best_match: type: object nullable: true properties: session_id: type: string format: uuid nullable: true session_number: type: integer nullable: true vendor_user_id: type: string format: uuid nullable: true similarity_percentage: type: number nullable: true earlier_verifications: type: object nullable: true properties: count: type: integer vendor_user_id: type: string format: uuid nullable: true networks: type: object nullable: true properties: count: type: integer open: type: integer dismissed: type: integer items: type: array items: type: object properties: network_id: type: string format: uuid display_number: type: integer nullable: true name: type: string status: type: string risk_score: type: number nullable: true workflow_id: type: string format: uuid description: >- このセッションを生成したワークフローグループの不変の識別子。ワークフローはバージョン管理されており、この値は特定のバージョンではなくワークフロー自体を識別します。 nullable: true features: type: array items: type: string description: セッションの機能です。 description: >- このセッションに設定された認証機能のリストで、表示名で示されます。`ID_VERIFICATION`、`NFC`、`LIVENESS`、`FACE_MATCH`、`POA`、`PHONE`、`EMAIL_VERIFICATION`、`AML`、`IP_ANALYSIS`、`DATABASE_VALIDATION`、`QUESTIONNAIRE`、`AGE_ESTIMATION`、`FACE_SEARCH`、`GEOLOCATION`（位置情報認証）があります（法人確認 (KYB)のセッションではKYBの機能セットである`KYB_REGISTRY`、`KYB_DOCUMENTS`、`KYB_KEY_PEOPLE`、`AML`、`PHONE`、`EMAIL_VERIFICATION`、`IP_ANALYSIS`、`QUESTIONNAIRE`を使用します）。`include=events`を指定すると、各エントリはプレーンな文字列ではなくオブジェクト`{feature, node_id}`になり、メール機能の名前が変わります。イベントモードでは、ここで使用される`EMAIL_VERIFICATION`ではなく`EMAIL`として表示されます。 vendor_data: type: string description: セッションのベンダーデータ。 nullable: true metadata: type: object description: セッションのメタデータです。 nullable: true expected_details: type: object description: >- セッション作成時に指定された想定情報です。抽出データとの照合（KYC）や、法人登記検索の事前入力（KYB）に使用されます。指定されたキーのみをそのまま返し、何も指定されなかった場合は`null`になります。KYCセッションには個人のフィールドが含まれ、法人確認 (KYB)セッションには`company_name`、`registry_country`、`registration_number`が含まれます。 properties: first_name: type: string description: 'ユーザーの名。例: `John`。' last_name: type: string description: 'ユーザーの姓。例: `Doe`。' date_of_birth: type: string format: date description: 'ユーザーの生年月日（形式: YYYY-MM-DD）。例: `1990-05-15`。' gender: type: string nullable: true enum: - M - F default: null description: ユーザーの性別。'M'、'F'、nullのいずれかである必要があります。 nationality: type: string description: '申請者の出身国を示すISO 3166-1 alpha-3コード。例: `USA`。' country: type: string description: >- 住所証明書類の国、または申請者の身分証明書類の国を示すISO 3166-1 alpha-3コード。国籍とは異なる場合があります。例: `GBR`。 address: type: string description: >- 人が読める形式の住所。できるだけ多くの情報を含めてください。例: `123 Main St, San Francisco, CA 94105, USA`。 identification_number: type: string description: 'ユーザーの書類番号、個人番号、または納税者番号。例: `123456789`。' ip_address: type: string format: ipv4 description: >- セッションで想定されるIPアドレスです。実際のIPアドレスがこの値と異なる場合、警告がログに記録されます。例: `192.168.1.100`。 expected_document_types: type: array description: >- セッション作成時に本人確認ステップで受け付けるよう制限された書類種別。空または未設定の場合は制限なし。コード: `P`(パスポート)、`ID`(国民IDカード)、`DL`(運転免許証)、`RP`(在留許可証)、`HIC`(健康保険証)、`TC`(税務カード)、`SSC`(社会保障カード)。 items: type: string enum: - P - ID - DL - RP - HIC - TC - SSC id_country: type: string nullable: true description: 想定されるID書類の発行国（ISO 3166-1 alpha-3）です。作成時に制限した場合に含まれます。 example: ESP poa_country: type: string nullable: true description: 想定される住所証明書類の国（ISO 3166-1 alpha-3）です。作成時に制限した場合に含まれます。 example: ESP company_name: type: string description: 企業の想定される正式名称です。法人確認 (KYB)セッションのみ。 registry_country: type: string description: >- 想定される登記国です。`XX`または`XX-YY`の形式で指定します（ISO 3166-1 alpha-2。州レベルの登記の場合はISO 3166-2の地域区分を付加できます。例: `US-CA`）。法人確認 (KYB)セッションのみ。 registration_number: type: string description: 想定される法人の登記番号です。企業（KYB）セッションのみが対象です。 nullable: true contact_details: type: object description: >- セッション作成時に提供された連絡先情報（通知メール、電話番号・メールアドレス検証の事前入力、コミュニケーション言語に使用）。メールアドレスと電話番号のどちらも提供されなかった場合は`null`です。 properties: email: type: string description: >- メールアドレス認証ステップで使用されるユーザーのメールアドレス（例："john.doe@example.com"）。指定しない場合、ユーザーは認証フロー中に入力する必要があります。 email_lang: type: string description: メール通知の言語コード（ISO 639-1）。すべてのメール連絡の言語を制御します（例："en"、"es"、"fr"）。 send_notification_emails: type: boolean default: false description: >- trueに設定し、メールアドレスを指定した場合、ユーザー認証(KYC)または法人確認(KYB)のセッション作成時に、Diditは最初の「Verify your identity」メールを非同期で送信します。また、手動レビューが必要なセッションについては、認証ステータスの通知も指定したメールアドレスに送信します。 phone: type: string nullable: true description: >- 利用可能な場合、E.164形式のユーザーの電話番号(例: +14155552671)。セッション作成時にメールアドレスのみが指定された場合は`null`です。注: このフィールドはセッション作成時に指定された元の電話番号を返します。番号が無効だった場合、E.164形式でない可能性があります。 nullable: true callback: type: string format: uri description: セッションのコールバックURL。 nullable: true id_verifications: type: array nullable: true description: >- **本人確認(OCR)レポートの配列**。ワークフローグラフ内の本人確認書類ステップによって生成されます。常にJSON配列です。`id_verifications[0]`を読み取り、ワークフローで複数の本人確認を実行できる場合(たとえば一次確認に加えて追加確認を行う場合)は反復処理してください。少なくとも1つの本人確認ステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、抽出された書類フィールド、画像URL、品質スコア、MRZ、住所の解析結果、セッション間の一致、`warnings[]`を含みます。 items: type: object description: >- 1件の本人確認レポート。単一の本人確認ステップの完全なレポートです。`verification_method`は3つの方法(書類撮影、書類不要の照会、ウォレットサインイン)のうちどれで生成されたかを示し、方法固有の証拠ブロックがそれに応じて設定されます。 properties: node_id: type: string description: このレポートを生成したOCRステップのワークフローグラフのノードID。 verification_method: type: string enum: - document - id_lookup - wallet description: >- このレポートを生成した本人確認の方法。`document`：ユーザーが物理的な身分証明書を撮影しました（デフォルト値であり、他の方法が導入される前に作成されたすべてのセッションの値です）。`id_lookup`：ユーザーが国民ID番号を入力し、その国の政府登録簿またはその他の信頼できる情報源と照合されました（どの情報源かは`id_lookup.source`に示されます）。`wallet`：ユーザーが政府または銀行のデジタルIDでサインインしました。 assurance: type: string enum: - documentary - data_match - cryptographic description: >- `verification_method`から導出される保証レベル。`documentary`は撮影・検証された書類、`data_match`は照会先が保持する記録と一致した情報、`cryptographic`はIDプロバイダーが認証し署名した属性を示します。 wallet_provider: type: string nullable: true description: >- `verification_method`が`wallet`の場合のカタログウォレットID（`mitid`、`bankid_se`、`itsme`など）。それ以外の場合は`null`です。 fallback_from: type: object nullable: true description: >- 書類以外の方法によってIDステップが終了した理由です。照会またはウォレットサインインが失敗し、その国のフォールバック設定が`decline`だった場合に、却下されたレポートに設定されます。それ以外の場合は`null`です。 properties: method: type: string enum: - id_lookup - wallet description: 失敗したメソッドです。 reason: type: string description: >- それを終了させた結果。例: `no_match`、`provider_error`、`cancelled`、`timeout`。 action: type: string description: 実行された設定済みのアクション。例:`decline`。 id_lookup: type: object nullable: true description: >- 登記の証拠。`verification_method`が`id_lookup`の場合にのみ存在し、それ以外の場合は`null`です。 properties: source: type: string description: >- 照会したソースの顧客向け名称。例：`Department of Home Affairs`（政府の登録簿）、`UK credit bureau and financial services records`（政府の登録簿ではない）。これは照会の出所を示す唯一の記述です。政府のソースであると想定しないでください。 checked_at: type: string format: date-time nullable: true description: 登記簿が応答した日時。 attempts: type: integer description: このレポートの元となった試行の番号（1始まり）。 max_attempts: type: integer description: 国ごとに設定された試行回数の上限(1〜5、デフォルトは1)。 outcome: type: string enum: - match - partial_match - no_match - provider_error - format_rejected nullable: true description: >- 登録機関の回答です。試行回数の上限にカウントされ、課金されるのは`match`、`partial_match`、`no_match`のみです。 comparison: type: array description: >- ソースが回答した比較可能なフィールドごとに1行、さらにソースのエラーごとに1行です。比較行には国ごとのリクエストフィールドキーではなく、以下の正規化されたフィールド名を使用します。複数のリクエストフィールド（名と姓、または識別子のエイリアスのいずれか）が1つの比較にまとめられるためです。失敗したソースは`field: "provider"`と`result: "error"`を持つ行を追加するため、行をフィールドの判定として扱う前に`result`を確認してください。 items: type: object required: - field - label - provided - record - result properties: field: type: string enum: - identification_number - full_name - date_of_birth - address - provider description: >- 正規化された比較フィールド。`provider`はユーザーフィールドではなく、ソースのエラー行であることを示します。 label: type: string description: 行の表示ラベルです。例：`ID number`、`Full name`、`Provider`。 provided: type: string nullable: true description: ユーザーが入力した値です。`provider`エラー行では`null`です。 record: type: string nullable: true description: ソースが保持していた値です。`provider`エラー行では、代わりにエラーメッセージが入ります。 result: type: string enum: - match - partial - no_match - error description: >- フィールドごとの比較結果。`error`は`provider`行にのみ表示され、そのソースが応答しなかったことを意味します。これはクエリに関する証跡として扱い、決してフィールドの不一致として扱わないでください。 registry_portrait: type: string format: uri nullable: true description: >- ソースが返した顔写真への有効期間の短い署名付きURL。顔写真を返す4つの政府登録簿（南アフリカ、ナイジェリア、アルゼンチン、パナマ）のみが対象です。 face_match_score: type: number nullable: true description: セルフィーと登記所の顔写真との照合結果(0-100)です。登記所が顔写真を返す場合のみです。 wallet_verification: type: object nullable: true description: >- クレデンシャルの証拠。`verification_method`が`wallet`の場合にのみ存在し、それ以外の場合は`null`です。 properties: provider: type: string description: 'カタログウォレットID（例: `mitid`）。' provider_name: type: string nullable: true description: 'エンドユーザーが認識しているウォレット名（例: `MitID`）。' issuing_authority: type: string nullable: true description: ウォレットを提供する機関。例：`Danish Agency for Digital Government`。 issuing_country: type: string description: ウォレットが提供された国のISO 3166-1 alpha-3コード。 credential_type: type: string nullable: true description: 'ウォレットが提示したクレデンシャル（例: `person_identification`）。' level_of_assurance: type: string enum: - low - substantial - high nullable: true description: >- ウォレットが表明した保証レベルです。要求されたレベルより低いレベルを表明したサインインは、レベルを下げるのではなく失敗します。 verified_at: type: string format: date-time nullable: true description: ウォレットでの認証日時。 signature_valid: type: boolean nullable: true description: ウォレットが返した署名付きアサーションが検証に成功したかどうか。 attributes: type: object additionalProperties: true description: ウォレットが共有した属性。ウォレットのカタログエントリーに記載されたキーで格納されます。 portrait: type: string format: uri nullable: true description: ウォレットが顔写真を共有した場合の、その顔写真への有効期間の短い署名付きURL。 face_match_score: type: number nullable: true description: セルフィーとウォレットの顔写真との照合結果(0-100)です。ウォレットが顔写真を共有する場合に限ります。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Expired description: >- この本人確認ステップの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 document_type: type: string description: 本人確認書類の種類 document_subtype: type: string nullable: true description: >- ワークフローの書類設定で受け付ける書類サブタイプのコードです（該当する場合は書類の地域を含みます）。例：`ID_CARD_GENERIC`、`QUEENSLAND_DRIVER_LICENSE_GENERIC`。 document_number: type: string description: 書類の識別番号 personal_number: type: string description: 個人識別番号 portrait_image: type: string format: uri description: 顔写真画像のURL front_image: type: string format: uri description: 書類表面画像のURL front_video: type: string format: uri description: 書類表面の動画のURL back_image: type: string format: uri description: 書類裏面画像のURL back_video: type: string format: uri description: 書類裏面の動画のURL full_front_image: type: string format: uri description: 書類表面全体の画像のURL full_back_image: type: string format: uri description: 書類裏面全体の画像のURL front_image_camera_front: type: string format: uri description: 前面カメラで撮影された書類表面画像のURL back_image_camera_front: type: string format: uri description: 前面カメラで撮影された書類裏面画像のURL date_of_birth: type: string format: date description: 書類記載の生年月日 age: type: integer description: 生年月日から算出された年齢 expiration_date: type: string format: date description: 書類の有効期限 date_of_issue: type: string format: date description: 書類の発行日 issuing_state: type: string description: 発行国のISOコード issuing_state_name: type: string description: 発行国の正式名称 first_name: type: string description: 書類に記載された名 last_name: type: string description: 書類から取得した姓 full_name: type: string description: 書類上の氏名 gender: type: string description: 書類上の性別 address: type: string description: 書類から取得した生の住所 formatted_address: type: string description: 整形済みの完全な住所 place_of_birth: type: string description: 書類に記載された出生地 marital_status: type: string description: 書類に記載された婚姻状況 nationality: type: string description: 国籍のISOコード extra_fields: type: object description: >- 追加の書類フィールド。書類固有の属性（例：`dl_categories`、`blood_group`、`sponsor`、`employer`、`dl_class_code_b_from`、`dl_class_code_b_to`）が含まれます。運転免許証の区分ごとの有効日は`dl_class_code__from`および`dl_class_code__to`として、区分ごとの制限/情報コード（例：英国の免許証の12欄）は`dl_class_code__notes`として返されます。書類に氏名、住所、出生地が複数の文字体系で記載されている場合、このオブジェクトにはそれらのフィールドの別の文字体系版も含まれます。ワークフロー設定の`preferred_characters`（`latin`または`non_latin`）によって、トップレベルのフィールド（`first_name`、`last_name`、`full_name`、`address`、`place_of_birth`）にどの文字体系が入るかが決まります。もう一方の文字体系は、`preferred_characters`が`latin`の場合は`first_name_non_latin` / `last_name_non_latin` / `full_name_non_latin` / `middle_name_non_latin` / `address_non_latin` / `place_of_birth_non_latin`としてここに入り、`preferred_characters`が`non_latin`の場合は`_latin`サフィックス付きで入ります。キーは、OCRが実際に別の文字体系の値を抽出した場合にのみ表示されます。別の文字体系の値が優先設定と同じ文字体系であるフィールド（例えば、キリル文字のラベルが付いたフィールドで、OCRの値がラテン文字のホモグリフで返された場合）はスキップされます。`preferred_characters`が`latin`でも書類に非ラテン文字のテキストしかない場合、Diditは抽出した値を翻字し、フォールバックとして`first_name_latin` / `last_name_latin`などを提供します。 additionalProperties: true properties: dl_categories: type: array items: type: string blood_group: type: string nullable: true first_name_non_latin: type: string description: >- `preferred_characters=latin`で書類に非ラテン文字表記がある場合の、非ラテン文字表記の名です（例：キルギスのIDの`Айна`）。 last_name_non_latin: type: string description: >- `preferred_characters=latin`で、書類に非ラテン文字の表記がある場合の、非ラテン文字表記の姓。 middle_name_non_latin: type: string description: >- `preferred_characters=latin`で、書類に非ラテン文字の表記がある場合の、非ラテン文字表記のミドルネーム／父称。 full_name_non_latin: type: string description: 非ラテン文字で構成された氏名。名と姓の両方が利用可能な場合は、個々の構成要素から再構成されます。 address_non_latin: type: string description: >- `preferred_characters=latin`で、書類に非ラテン文字の表記がある場合の、非ラテン文字表記の住所。 place_of_birth_non_latin: type: string description: >- `preferred_characters=latin`で、書類に非ラテン文字の表記がある場合の、非ラテン文字表記の出生地。 first_name_latin: type: string description: >- ラテン文字表記の名です。`preferred_characters=non_latin`で書類にラテン文字表記がある場合、または音訳によるフォールバックとして、`preferred_characters=latin`で書類に非ラテン文字のテキストしかない場合に設定されます。 last_name_latin: type: string description: ラテン文字表記の姓。`first_name_latin`と同じルールが適用されます。 middle_name_latin: type: string description: ラテン文字表記のミドルネーム／父称。ルールは`first_name_latin`と同じです。 full_name_latin: type: string description: ラテン文字で構成された氏名。名と姓の両方が利用可能な場合は、常に個々の構成要素から再構成されます。 address_latin: type: string description: ラテン文字表記の住所。`first_name_latin`と同じルールが適用されます。 place_of_birth_latin: type: string description: ラテン文字表記の出生地。`first_name_latin`と同じルールが適用されます。 mrz: type: object nullable: true description: 書類から抽出された機械読み取りゾーン(MRZ)の解析済みフィールド。MRZが検出されなかった場合は`null`です。 properties: surname: type: string example: MARTINEZ- 書類撮影中にフロントカメラが撮影したセルフィーと顔が一致した過去のセッションまたは顔ブロックリストのエントリ(Silent Capture Face Search)。エントリの形式は`liveness_checks[].matches`と同じです。このフィールドが存在する前に作成されたセッション、または検索が実行されなかった場合は`null`です。検索が実行されて何も見つからなかった場合は空の配列です。`match_image_url`は有効期限のある署名付きURLです。 items: type: object properties: session_id: type: string format: uuid nullable: true description: >- 一致した顔のセッションID。`source`が`imported`、`list_entry`、`retained_template`の場合は`null`です。 session_number: type: integer nullable: true similarity_percentage: type: number description: 2つの画像間の顔の類似度。0～100の範囲に制限されます。 vendor_data: type: string nullable: true description: >- 一致したセッション、またはインポートされた顔および保持されたテンプレートの顔の場合は紐付けられたユーザーの`vendor_data`です。 vendor_user_id: type: string format: uuid nullable: true description: >- `imported`および`retained_template`の一致と、ユーザーにリンクされたセッションの一致における、リンクされたユーザーのID。リストエントリおよびユーザーのないセッションの場合は`null`。 biometric_template_id: type: string format: uuid nullable: true description: >- 保持された生体認証テンプレートのID。`source`が`retained_template`の場合のみ設定され、それ以外の場合は`null`です。 verification_date: type: string format: date-time nullable: true description: 一致する顔が撮影された日時、または保持されたテンプレートが作成された日時。リストのエントリでは`null`です。 user_details: type: object nullable: true description: >- 一致したセッションまたはインポートされたユーザープロフィールの本人データ。`retained_template`および`list_entry`の一致では常に`null`です。 properties: full_name: type: string nullable: true document_type: type: string nullable: true document_number: type: string nullable: true match_image_url: type: string format: uri nullable: true description: >- 画像に基づく一致の基準画像。保持されたテンプレートには画像が含まれないため、`retained_template`の一致では常に`null`です。 status: type: string nullable: true description: 一致したセッションのライフサイクルステータス。セッション以外のソースの場合は`null`。 is_blocklisted: type: boolean description: 一致した顔がブロックリストに登録されているかどうか。 is_allowlisted: type: boolean description: 一致した顔が許可リストに登録されているかどうか。 api_service: type: string nullable: true description: >- 一致したセッションのスタンドアロンAPIサービス（例: `PASSIVE_LIVENESS`、`FACE_MATCH`）。ワークフローセッションおよびセッション以外のソースでは`null`です。 source: type: string enum: - session - imported - list_entry - retained_template description: >- 一致した顔の出所です：`session`、`imported`（ユーザーの顔アップロード）、`list_entry`（許可リスト/ブロックリスト）、または`retained_template`（ユーザーに保存された画像を含まない生体認証テンプレートで、`/v3/biometric-templates/`に一覧表示されます）。 nullable: true front_image_quality_score: type: object nullable: true description: 書類表面画像の品質指標。各サブスコアの範囲は0から100です。 properties: focus_score: type: number description: >- 上位10%の局所ラプラシアン分散で測定した画像の鮮明度。大きな均一背景を持つ書類にも頑健です。値が高いほど、ぼやけの少ない鮮明な画像であることを示します。 brightness_score: type: number description: 画像の明るさの度合い。暗すぎる画像や露出過多の画像は減点され、理想的な明るさは中間程度です。 brightness_issue: type: string enum: - ok - too_dark - too_bright description: >- brightness_scoreが低い場合に、明るさの問題の方向を示します。'ok'は明るさが許容範囲であること、'too_dark'は画像が露出不足であること、'too_bright'は画像が露出過多であることを意味します。 is_document_fully_visible: type: boolean nullable: true description: >- 書類の四隅すべてが画像フレーム内に完全に収まっている場合はtrue、いずれかの角が切れている場合はfalseです。角の座標が利用できない場合はnullです。 resolution_score: type: number description: 総ピクセル数に基づく画像の実効解像度。 overall_score: type: number description: サブスコアの加重合成値（フォーカス45%、明るさ30%、解像度25%）。 back_image_quality_score: type: object nullable: true description: 書類裏面画像の品質指標。front_image_quality_scoreと同じ構造です。 properties: focus_score: type: number description: >- 上位10%の局所ラプラシアン分散で測定した画像の鮮明度。大きな均一背景を持つ書類にも頑健です。値が高いほど、ぼやけの少ない鮮明な画像であることを示します。 brightness_score: type: number description: 画像の明るさの度合い。暗すぎる画像や露出過多の画像は減点され、理想的な明るさは中間程度です。 brightness_issue: type: string enum: - ok - too_dark - too_bright description: >- brightness_scoreが低い場合に、明るさの問題の方向を示します。'ok'は明るさが許容範囲であること、'too_dark'は画像が露出不足であること、'too_bright'は画像が露出過多であることを意味します。 is_document_fully_visible: type: boolean nullable: true description: >- 書類の四隅すべてが画像フレーム内に完全に収まっている場合はtrue、いずれかの角が切れている場合はfalseです。角の座標が利用できない場合はnullです。 resolution_score: type: number description: 総ピクセル数に基づく画像の実効解像度。 overall_score: type: number description: サブスコアの加重合成値（フォーカス45%、明るさ30%、解像度25%）。 warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です（例: `ID_VERIFICATION`、`NFC`、`LIVENESS`）。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われますが、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true description: 警告に関する追加のコンテキストデータ log_type: type: string description: ログの種類：情報、警告、またはエラー short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID(グラフベースのワークフローの場合) description: 書類検証の警告 matches: type: array description: 重複/ブロックリスト検出で見つかった一致する書類（最大5件） items: type: object properties: session_id: type: string format: uuid description: 一致した書類のセッションID session_number: type: integer description: 一致した書類のセッション番号 vendor_data: type: string nullable: true description: 一致したセッションに関連付けられたベンダーデータ verification_date: type: string format: date-time description: 一致したセッションが認証された日付 user_details: type: object properties: name: type: string description: 一致した書類上の氏名 document_type: type: string description: 一致した書類の種類 document_number: type: string description: 一致した書類の書類番号 status: type: string description: 一致したセッションのステータス is_blocklisted: type: boolean description: 一致した書類がブロックリストに登録されているかどうか api_service: type: string nullable: true description: 一致するセッションのAPIサービスタイプ front_image_url: type: string format: uri nullable: true description: 一致した書類の表面画像のURL document_liveness: type: object nullable: true description: >- 不正の種類ごとの書類ライブネススコアです。警告が発生したかどうかにかかわらず報告されるため、承認済みの書類も監査できます。チェックが実行されなかった場合は`null`です。 properties: portrait_replace: type: object nullable: true properties: score: type: number nullable: true description: >- この不正タイプについて書類が本物である可能性（0〜100、値が高いほど本物である可能性が高い）。2つの面のうち低い方の値で、判定に使用された値です。どちらの面からも有効なスコアが得られなかった場合は`null`。 front: type: number nullable: true description: 表面のスコア。撮影されていない場合、またはスコアが除外された場合は`null`です。 back: type: number nullable: true description: 裏面のスコア。撮影されていない場合、またはスコアが除外された場合は`null`です。 decline_threshold: type: number nullable: true description: >- この書類が評価された時点で保存された却下のしきい値です。その後ワークフローを編集しても変更されません。過去の評価エビデンスが利用できない場合はnullです。 review_threshold: type: number nullable: true description: >- この書類が評価された時点で保存されたレビューしきい値です。その後ワークフローを編集しても変更されません。過去の評価エビデンスが利用できない場合はnullです。 bucket: type: string nullable: true enum: - approve - review - decline - null description: >- 評価時に保存された不正タイプの区分です。利用可能なスコアがない場合、チェックが適用されなかった場合、または過去の評価の根拠データが利用できない場合はnullです。後からワークフローを編集しても変更されません。 printed_copy: type: object nullable: true properties: score: type: number nullable: true description: >- この不正タイプについて書類が本物である可能性（0〜100、値が高いほど本物である可能性が高い）。2つの面のうち低い方の値で、判定に使用された値です。どちらの面からも有効なスコアが得られなかった場合は`null`。 front: type: number nullable: true description: 表面のスコア。撮影されていない場合、またはスコアが除外された場合は`null`です。 back: type: number nullable: true description: 裏面のスコア。撮影されていない場合、またはスコアが除外された場合は`null`です。 decline_threshold: type: number nullable: true description: >- この書類が評価された時点で保存された却下のしきい値です。その後ワークフローを編集しても変更されません。過去の評価エビデンスが利用できない場合はnullです。 review_threshold: type: number nullable: true description: >- この書類が評価された時点で保存されたレビューしきい値です。その後ワークフローを編集しても変更されません。過去の評価エビデンスが利用できない場合はnullです。 bucket: type: string nullable: true enum: - approve - review - decline - null description: >- 評価時に保存された不正タイプの区分です。利用可能なスコアがない場合、チェックが適用されなかった場合、または過去の評価の根拠データが利用できない場合はnullです。後からワークフローを編集しても変更されません。 screen_replay: type: object nullable: true properties: score: type: number nullable: true description: >- この不正タイプについて書類が本物である可能性（0〜100、値が高いほど本物である可能性が高い）。2つの面のうち低い方の値で、判定に使用された値です。どちらの面からも有効なスコアが得られなかった場合は`null`。 front: type: number nullable: true description: 表面のスコア。撮影されていない場合、またはスコアが除外された場合は`null`です。 back: type: number nullable: true description: 裏面のスコア。撮影されていない場合、またはスコアが除外された場合は`null`です。 decline_threshold: type: number nullable: true description: >- この書類が評価された時点で保存された却下のしきい値です。その後ワークフローを編集しても変更されません。過去の評価エビデンスが利用できない場合はnullです。 review_threshold: type: number nullable: true description: >- この書類が評価された時点で保存されたレビューしきい値です。その後ワークフローを編集しても変更されません。過去の評価エビデンスが利用できない場合はnullです。 bucket: type: string nullable: true enum: - approve - review - decline - null description: >- 評価時に保存された不正タイプの区分です。利用可能なスコアがない場合、チェックが適用されなかった場合、または過去の評価の根拠データが利用できない場合はnullです。後からワークフローを編集しても変更されません。 address_validation: allOf: - $ref: '#/components/schemas/AddressValidationResult' nullable: true description: >- この書類に記載された住所の住所検証（Address Validation）です。住所が存在するかどうかと、書類から読み取った正規化された形式を示します（後から`address`を修正しても再実行されません）。この本人確認ステップでAddress Validationアドオンが有効化された場合に存在し、それ以外の場合は`null`です。 region: type: string nullable: true description: 書類で特定されている場合の、書類の発行国の地域または州。 extracted_data: type: object nullable: true additionalProperties: true description: >- 本人に確認のため提示された、書類から抽出されたデータのスナップショットです。確認済みの値と並べて保持されるため、読み取られた内容と本人が確認した内容を比較できます。本人に確認が求められなかった場合は`null`です。 barcodes: type: array items: type: object additionalProperties: true description: 書類のバーコードから読み取られたデータ。書類にバーコードがない場合、または読み取れなかった場合は空になります。 nfc_skip_reason: type: string nullable: true enum: - USER_SKIPPED - DOCUMENT_WITHOUT_CHIP - CHIP_CERTIFICATE_UNAVAILABLE - DEVICE_WITHOUT_NFC - INTEGRATION_WITHOUT_NFC_ACCESS - MRZ_KEY_UNAVAILABLE - JPKI_UNAVAILABLE description: >- NFCチップ検証が実行されなかった理由です。ワークフローにNFCステップが含まれる場合は常に設定されます。NFCが保留中の間、またはチップが実際に読み取られた場合は`null`です。値：`USER_SKIPPED` - NFC対応デバイスでユーザーがスキップを選択した（`allow_nfc_skip`で許可されている場合）；`DOCUMENT_WITHOUT_CHIP` - 書類に読み取り可能なNFCチップがない（ICAO 9303の電子書類ではない）；`CHIP_CERTIFICATE_UNAVAILABLE` - 書類の発行期間をカバーする発行国の署名証明書（CSCA）が利用できないため、チップの署名を検証できない；`DEVICE_WITHOUT_NFC` - デバイスがNFCリーダーを搭載していないと報告した；`INTEGRATION_WITHOUT_NFC_ACCESS` - ネイティブSDKを使わずに（例：Webブラウザで）認証が実行されたため、スマートフォンのNFCリーダーにアクセスできない；`MRZ_KEY_UNAVAILABLE` - 書類のMRZからチップのアクセスキーを導出できなかった；`JPKI_UNAVAILABLE` - 書類が日本のマイナンバーカードで、そのチップはJPKI経由で読み取られるが、この認証ではJPKIが利用できなかった（有効化されていない、またはアプリのネイティブSDKがマイナンバーカードを読み取れない）。 nfc_verifications: type: array nullable: true description: >- **NFC / ePassportレポートの配列**。ワークフローグラフ内のNFCステップによって生成されます。**これは常にJSON配列であり、単一の`nfc`オブジェクトになることはありません**。`nfc_verifications[0]`を読み取り、ワークフローでNFCを複数回実行できる場合は反復処理してください。少なくとも1つのNFCステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、`chip_protocol`、`chip_data`、`authenticity`(SOD + DGの完全性)、`certificate_summary`、`warnings[]`を含みます。日本のマイナンバーカードはICAO 9303ではなくJPKIを通じて読み取られます。その要素は`chip_protocol: "jpki"`を持ち、証跡を`jpki`の下に格納し、ICAOのフィールドは`null`のままです。NFCステップが提示される前にバイパスされた場合(チップのない書類、証明書の欠落、NFC機能の報告なし、読み取れないMRZキー、マイナンバーカードでJPKIが利用できない場合)、この値は`null`のままで、`nfc_skip_reason`がその理由を示します。ステップ自体でのスキップ(ユーザーがスキップをタップした場合、またはスキャン時にリーダーが利用できないと判明した場合)でも、`is_nfc_skipped: true`を含むレポートが生成されます。 items: type: object description: >- 1件のNFCレポート: 1回のチップ読み取りの完全なレポートです(ICAO 9303準拠のePassportまたはeIDチップ、あるいはJPKI経由で読み取ったマイナンバーカード)。 properties: node_id: type: string description: >- このレポートを生成したNFCステップのワークフローグラフのノードID。レポートとワークフロー定義を関連付けるために使用します。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: >- このNFCステップの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 is_nfc_skipped: type: boolean description: >- このNFCステップが読み取られずに明示的にスキップされた場合は`true`です。理由は`skip_reason`に示されます。 skip_reason: type: string nullable: true enum: - USER_SKIPPED - DOCUMENT_WITHOUT_CHIP - CHIP_CERTIFICATE_UNAVAILABLE - DEVICE_WITHOUT_NFC - INTEGRATION_WITHOUT_NFC_ACCESS - MRZ_KEY_UNAVAILABLE - JPKI_UNAVAILABLE description: >- このNFCステップがスキップされた理由。`is_nfc_skipped`が`true`の場合にのみ設定されます。セッションレベルの`nfc_skip_reason`と同じ分類ですが、そちらはNFCがレポートをまったく生成しなかったケースも対象とします。 chip_protocol: type: string enum: - icao - jpki description: >- NFCステップがチップを読み取る方法。`icao`：ICAO 9303準拠のePassportまたはeIDチップで、MRZから得たアクセスキーで開きます。`jpki`：日本のマイナンバーカードで、所有者がネイティブSDKでカードのPINを入力した後、カードがワンタイムチャレンジに署名します。結果は`jpki`の下に格納されます。スキップされたステップにも設定されるため、マイナンバーカードの読み取りがスキップされたことを区別できます。 jpki: type: object nullable: true description: >- JPKIを通じて読み取った日本のマイナンバーカードによって証明された内容。`chip_protocol`が`jpki`で、カードが読み取られた場合に存在します。ICAOチップ、スキップされたステップ、およびカードを一度も読み取らずにNFCステップが終了した場合（この場合は`JPKI_SIGNATURE_INVALID`が発生します）は`null`です。証明書、そのシリアル番号、署名、12桁のマイナンバーは決して含まれません。 properties: certificate_types: type: array items: type: string enum: - user_authentication - signature description: >- 読み取られたカードの証明書。`user_authentication`（4桁のPIN）は常に読み取られ、`signature`（署名用PIN）はNFCノードの`jpki_request_attributes`設定がオンの場合に読み取られます。 chain_valid: type: boolean description: >- 読み取ったすべての証明書がJPKI認証局につながる証明書チェーンを持ち、有効期間内であり、その種類のマイナンバーカード証明書である場合は`true`です。 signature_valid: type: boolean description: >- ワンタイムチャレンジに対してカードが作成したすべての署名の検証に成功した場合は`true`です。カードはPINが入力された後にのみ署名するため、これによりカードの所持とPINの知識が証明されます。 revocation_status: type: string enum: - good - revoked - unchecked description: >- 失効確認ですべての証明書が有効と確認された場合は`good`、いずれかの証明書が失効している場合（例: 紛失届が出されたカード）は`revoked`、失効確認の回答が得られなかった場合は`unchecked`です。`unchecked`が`good`として扱われることはありません。結果はNFCノードの`jpki_revocation_unchecked_action`で決まります（デフォルトは`REVIEW`）。 ca_generation: type: string nullable: true description: >- 証明書を発行したJPKI認証局の世代（例：`2023`）。いずれの証明書もその認証局に連鎖しない場合は`null`です。 certificate_expires_at: type: string format: date-time nullable: true description: 読み取った証明書のうち、最も早い有効期限です。 certificates: type: array items: type: object description: カードから読み取った1つの証明書が証明した内容です。証明書そのものやそのシリアル番号が含まれることはありません。 properties: type: type: string enum: - user_authentication - signature description: このエントリが表すカード証明書。 chain_valid: type: boolean description: >- 証明書がその種類のJPKI認証局につながる証明書チェーンを持ち、有効期間内であり、その種類のマイナンバーカード証明書である場合は`true`です。 signature_valid: type: boolean description: ワンタイムチャレンジに対するカードの署名がこの証明書で検証に成功した場合は`true`です。 ca_generation: type: string nullable: true description: >- 証明書を発行したJPKI認証局の世代（例：`2023`）。信頼できる発行者が見つからない場合は`null`です。 not_valid_before: type: string format: date-time nullable: true description: 証明書の有効期間の開始日時です。証明書を読み取れなかった場合は`null`です。 not_valid_after: type: string format: date-time nullable: true description: 証明書の有効期間の終了日時。証明書を読み取れなかった場合は`null`です。 failure: type: string nullable: true enum: - unreadable_certificate - untrusted_issuer - expired - not_yet_valid - wrong_policy - key_usage - null description: >- `chain_valid`が`false`である理由です：`unreadable_certificate`、`untrusted_issuer`（その種類のJPKI認証局によって発行されていない）、`expired`、`not_yet_valid`、`wrong_policy`（その種類のマイナンバーカード証明書ではない）、または`key_usage`（その鍵は署名に使用できない）。チェーンが有効な場合は`null`です。 description: 証明書ごとの結果。読み取った証明書1件につき1エントリ。 attributes: type: object nullable: true description: >- 署名用電子証明書のチェーンが有効になった時点での、署名用電子証明書から得た名義人のデータです。署名用電子証明書がリクエストされなかった場合、またはJPKI認証局までチェーンをたどれなかった場合は`null`です。 properties: full_name: type: string nullable: true description: 登記上の名称。通常は日本語表記です。 date_of_birth: type: string format: date nullable: true description: 生年月日（`YYYY-MM-DD`）。登録された日付が不完全な場合は`null`です。 gender: type: string nullable: true enum: - M - F - null description: '`M`、`F`、または登録されていない場合は`null`です。' address: type: string nullable: true description: 登記住所。 name_substitute_characters: type: string nullable: true description: >- 元の文字が標準の文字セットに含まれないため代替文字に置き換えられた`full_name`の文字を示す位置文字列。置き換えがない場合は`null`です。 address_substitute_characters: type: string nullable: true description: >- `address`内の代替文字を示す位置文字列。`name_substitute_characters`と同様です。 attributes_match_ocr: type: boolean nullable: true description: >- 属性が同じカードの写真から読み取ったデータと一致する場合は`true`、いずれかの属性が異なる場合は`false`（`JPKI_AND_OCR_DATA_NOT_SAME`）、何も比較できなかった場合は`null`です。`attributes`が`null`の場合も、比較できなかった場合に含まれます。 mismatched_attributes: type: array items: type: string enum: - full_name - date_of_birth - gender - address description: 写真データと異なる属性の名前です。値は決して含まれません。比較したすべての項目が一致する場合は空です。 portrait_image: type: string format: uri nullable: true description: >- チップから読み取った顔写真（ICAO DG2）の署名付きURL。JPKIによる読み取り（`chip_protocol: "jpki"`）およびスキップされたステップでは`null`です。 signature_image: type: string format: uri nullable: true description: >- チップから読み取った所持者の署名画像（ICAO DG7）の署名付きURL。チップに保存されている場合に含まれます。JPKIによる読み取り（`chip_protocol: "jpki"`）およびスキップされたステップでは`null`です。 chip_data: type: object nullable: true description: >- ICAOチップのデータグループから解析された個人データ。JPKIの読み取り(`chip_protocol: "jpki"`)およびスキップされたステップでは`null`です。 properties: document_type: type: string issuing_country: type: string document_number: type: string expiration_date: type: string format: date first_name: type: string last_name: type: string birth_date: type: string format: date gender: type: string nationality: type: string address: type: string place_of_birth: type: string authenticity: type: object nullable: true description: >- ICAOパッシブ認証: SOD署名（`sod_integrity`）とData Groupのハッシュ（`dg_integrity`）。JPKIの読み取りでは`null`となり、その証明は`jpki`で報告されます。 properties: sod_integrity: type: boolean dg_integrity: type: boolean certificate_summary: type: object nullable: true description: >- ICAOのDocument Signer Certificate（書類署名者証明書）の概要。JPKIの読み取り（`chip_protocol: "jpki"`）およびスキップされたステップでは`null`です。 properties: issuer: type: string subject: type: string serial_number: type: string not_valid_after: type: string format: date-time not_valid_before: type: string format: date-time warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID liveness_checks: type: array nullable: true description: >- **ライブネスレポートの配列**。ワークフローグラフ内のライブネスステップによって生成されます。常にJSON配列であり、単一の`liveness`オブジェクトになることはありません。少なくとも1つのライブネスステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、`method`、`score`、`reference_image`、`video_url`、任意の`age_estimation`、セッション間の`matches[]`、`warnings[]`を含みます。 items: type: object description: ライブネスレポート1件。1回のライブネス判定の完全なレポートです。 properties: node_id: type: string description: このレポートを生成したライブネスステップのワークフローグラフのノードID。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: >- このライブネス検知ステップの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 method: type: string description: ライブネス検知に使用された方式 score: type: number description: ライブネスチェックの信頼度スコア reference_image: type: string format: uri description: 使用された参照画像のURL video_url: type: string format: uri description: ライブネスチェック動画のURL age_estimation: type: number description: 人物の推定年齢 matches: type: array description: >- 重複顔検索で見つかった類似の顔です(上位の一致結果で、ブロックリスト・許可リストに登録されたエントリが先に並びます)。各エントリの`source`は、一致した顔の出所を示します。`session`(別の認証セッション)、`imported`(ベンダーユーザーに対してアップロードされた顔)、`list_entry`(組織が管理する許可リスト・ブロックリストの顔)、`retained_template`(Userに保存された画像を含まない生体認証テンプレートで、`/v3/biometric-templates/`に一覧表示されます)のいずれかです。セッション以外のソースでは、`session_id`、`session_number`、`status`、`api_service`は`null`になります。`imported`の一致でも、ベンダーユーザーのレコードから`vendor_data`、`verification_date`、さらにベンダーユーザーの氏名が登録されている場合は`user_details`(`full_name`のみ)が設定されます。`retained_template`の一致では`vendor_user_id`、`vendor_data`、`biometric_template_id`、`verification_date`が設定され、画像および本人情報のフィールドは`null`になります。`list_entry`の一致では、これらすべてが`null`で返されます。 items: type: object properties: session_id: type: string format: uuid nullable: true description: >- 一致した顔のセッションID。`source`が`imported`、`list_entry`、`retained_template`の場合は`null`です。 session_number: type: integer nullable: true similarity_percentage: type: number description: 2つの画像間の顔の類似度。0～100の範囲に制限されます。 vendor_data: type: string nullable: true description: >- 一致したセッション、またはインポートされた顔および保持されたテンプレートの顔の場合は紐付けられたユーザーの`vendor_data`です。 vendor_user_id: type: string format: uuid nullable: true description: >- `imported`および`retained_template`の一致と、ユーザーにリンクされたセッションの一致における、リンクされたユーザーのID。リストエントリおよびユーザーのないセッションの場合は`null`。 biometric_template_id: type: string format: uuid nullable: true description: >- 保持された生体認証テンプレートのID。`source`が`retained_template`の場合のみ設定され、それ以外の場合は`null`です。 verification_date: type: string format: date-time nullable: true description: 一致する顔が撮影された日時、または保持されたテンプレートが作成された日時。リストのエントリでは`null`です。 user_details: type: object nullable: true description: >- 一致したセッションまたはインポートされたユーザープロフィールの本人データ。`retained_template`および`list_entry`の一致では常に`null`です。 properties: full_name: type: string nullable: true document_type: type: string nullable: true document_number: type: string nullable: true match_image_url: type: string format: uri nullable: true description: >- 画像に基づく一致の基準画像。保持されたテンプレートには画像が含まれないため、`retained_template`の一致では常に`null`です。 status: type: string nullable: true description: 一致したセッションのライフサイクルステータス。セッション以外のソースの場合は`null`。 is_blocklisted: type: boolean description: 一致した顔がブロックリストに登録されているかどうか。 is_allowlisted: type: boolean description: 一致した顔が許可リストに登録されているかどうか。 api_service: type: string nullable: true description: >- 一致したセッションのスタンドアロンAPIサービス（例: `PASSIVE_LIVENESS`、`FACE_MATCH`）。ワークフローセッションおよびセッション以外のソースでは`null`です。 source: type: string enum: - session - imported - list_entry - retained_template description: >- 一致した顔の出所です：`session`、`imported`（ユーザーの顔アップロード）、`list_entry`（許可リスト/ブロックリスト）、または`retained_template`（ユーザーに保存された画像を含まない生体認証テンプレートで、`/v3/biometric-templates/`に一覧表示されます）。 warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID face_quality: type: number nullable: true description: 顔画像の品質スコア（0-100%）。パッシブライブネスでのみ利用できます。 face_luminance: type: number nullable: true description: 顔の輝度/明るさスコア（0-100%）。パッシブライブネスでのみ利用できます。 face_matches: type: array nullable: true description: >- **顔照合レポートの配列**。ワークフローグラフ内の顔照合ステップによって生成されます。常にJSON配列であり、単一の`face_match`オブジェクトになることはありません。少なくとも1つの顔照合ステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、類似度の`score`、`source_image`、`target_image`、`warnings[]`を含みます。 items: type: object description: 顔照合レポート1件。完全なレポートです。 properties: node_id: type: string description: このレポートを生成した顔照合ステップのワークフローグラフのノードID。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: >- この顔照合ステップの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 score: type: number description: 顔照合の信頼度スコア source_image_session_id: type: string format: uuid nullable: true description: >- ソース（参照）ポートレートが保存されているセッションID。生体認証フローでは、これはセッション自身のIDです（送信されたポートレートは新しいセッションに保存されます）。ソース画像が同じセッションの書類のポートレートである場合は`null`です。 source_image: type: string format: uri description: 比較に使用されたソース画像のURL target_image: type: string format: uri description: 比較に使用されたターゲット画像のURL warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID description: 顔照合の検証に関する警告 face_coverage: type: object nullable: true description: >- 撮影画像で目、口、顔が覆われているかどうか。`GET /v3/session/{sessionId}/decision/`でのみ返され、Webhookペイロードには含まれません。覆われ具合の読み取り値が存在しない場合は`null`です。 properties: eyes: type: object properties: covered: type: boolean nullable: true calibrated: type: boolean nullable: true description: >- `false`は、その読み取り値がシャドーエビデンスにすぎず、どの警告もそれに基づいて作動しないことを意味します。 visibility_score: type: number nullable: true mouth: type: object properties: covered: type: boolean nullable: true calibrated: type: boolean nullable: true description: >- `false`は、その読み取り値がシャドーエビデンスにすぎず、どの警告もそれに基づいて作動しないことを意味します。 visibility_score: type: number nullable: true face: type: object properties: covered: type: boolean nullable: true calibrated: type: boolean nullable: true description: >- `false`は、その読み取り値がシャドーエビデンスにすぎず、どの警告もそれに基づいて作動しないことを意味します。 visibility_score: type: number nullable: true phone_verifications: type: array nullable: true description: >- **電話番号検証レポートの配列**。常にJSON配列であり、単一の`phone`オブジェクトになることはありません。少なくとも1つの電話番号ステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、電話番号と国のメタデータ、`lifecycle[]`、`matches[]`、`warnings[]`を含みます。 items: type: object properties: node_id: type: string description: ワークフローグラフ内のこの電話番号検証ステップの一意の識別子。 status: type: string description: >- この電話番号検証ステップの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 enum: - Not Finished - Approved - Declined - In Review - Expired phone_number_prefix: type: string description: 国際電話の国番号プレフィックス phone_number: type: string description: 国番号を除いた電話番号 full_number: type: string description: 国番号付きの完全な電話番号 country_code: type: string description: 2文字の国コード（ISO 3166-1 alpha-2） country_name: type: string description: 国の正式名称 carrier: type: object properties: name: type: string description: 電話通信事業者の名称 type: type: string description: 電話回線の種類（携帯電話、固定電話など） is_disposable: type: boolean description: 電話番号が使い捨てサービスのものかどうか is_virtual: type: boolean description: 電話番号が仮想番号かどうか verification_method: type: string description: 電話番号の検証に使用された方式 verification_attempts: type: integer description: 実行された認証の試行回数 verified_at: type: string format: date-time description: 電話番号が検証された日時 lifecycle: type: array description: 電話番号検証のライフサイクルにおけるイベントの時系列リストです。 items: type: object properties: type: type: string timestamp: type: string format: date-time details: type: object nullable: true description: >- イベント固有のペイロードです。送信イベントには`status`、`reason`、`channel`、`actual_channel`が、配信イベントには`channel`、`status`が、コード確認イベントには`code_tried`、`status`が、最終ステータスイベントには`reason`が含まれます。報告する理由がない場合(例: `PHONE_VERIFICATION_APPROVED`)は`null`になります。 properties: status: type: string reason: type: string nullable: true channel: type: string nullable: true actual_channel: type: string nullable: true code_tried: type: string fee: type: number warnings: type: array description: 電話番号検証に関する警告のリスト items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID matches: type: array description: >- この電話番号で見つかった一致です。各一致には`source`があります。`session`（アプリケーション内の別の認証セッションが同じ番号で一致したもの。`session_id`/`session_number`/`vendor_data`/`verification_date`とともに返されます）または`list_entry`（番号が組織で管理する許可リスト/ブロックリストに登録されているもの。`/management-api/lists/overview`を参照）のいずれかです。セッション間の一致は異なる`vendor_data`を使用し、上限は5件です。 items: type: object properties: session_id: type: string format: uuid nullable: true session_number: type: integer nullable: true vendor_data: type: string nullable: true verification_date: type: string format: date-time nullable: true phone_number: type: string status: type: string nullable: true is_blocklisted: type: boolean api_service: type: string nullable: true source: type: string enum: - session - list_entry description: >- この一致の発生元です。`session`は、アプリケーション内の別の認証セッションがこの値で一致したことを意味します。`list_entry`は、組織が管理するリスト（許可リスト/ブロックリスト）に対してこの値がヒットしたことを意味します。これらのリストの管理方法については、`/management-api/lists/overview`のManagement APIのリスト概要を参照してください。 phone_intelligence: allOf: - $ref: '#/components/schemas/PhoneIntelligence' description: 電話番号インテリジェンスのシグナル。この番号に対して電話番号インテリジェンスのアドオンが実行された場合にのみ含まれます。 phone_social: allOf: - $ref: '#/components/schemas/PhoneSocialFootprint' description: 番号のソーシャルフットプリント。この番号に対してソーシャルフットプリントアドオンが実行された場合にのみ含まれます。 email_verifications: type: array nullable: true description: >- **メールアドレス認証レポートの配列**。常にJSON配列であり、単一の`email`オブジェクトになることはありません。少なくとも1つのメールステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、メールアドレス、漏洩データ、`lifecycle[]`、`matches[]`、`warnings[]`を含みます。 items: type: object properties: node_id: type: string description: ワークフローグラフ内のこのメールアドレス認証ステップの一意の識別子。 status: type: string description: >- このメールアドレス認証ステップの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 enum: - Not Finished - Approved - Declined - In Review - Expired email: type: string description: 認証対象のメールアドレス is_breached: type: boolean description: メールアドレスが既知のデータ侵害で見つかったかどうかを示します breaches: type: array description: このメールアドレスが含まれていた既知の情報漏えいのリスト items: type: object properties: name: type: string description: 漏洩事案の名称 domain: type: string description: 漏洩の影響を受けたドメイン logo_path: type: string description: 漏洩したサービスのロゴへのURL breach_date: type: string format: date description: データ侵害が発生した日付 description: type: string description: 違反の説明 is_verified: type: boolean description: 漏えいが検証済みかどうか data_classes: type: array description: 漏えいで流出したデータの種類 items: type: string breach_emails_count: type: integer description: データ侵害で影響を受けたメールアドレスの数 is_disposable: type: boolean description: メールアドレスが使い捨てプロバイダーのものかどうかを示します is_undeliverable: type: boolean description: メールアドレスが配信不能かどうかを示します verification_attempts: type: integer description: このメールアドレスの認証試行回数 verified_at: type: string format: date-time description: メールアドレスが認証された日時 warnings: type: array description: メールアドレス認証に関する警告のリスト items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID lifecycle: type: array description: メールアドレス認証のライフサイクルにおけるイベントの時系列リストです。 items: type: object properties: type: type: string timestamp: type: string format: date-time details: type: object nullable: true description: >- イベント固有のペイロードです。送信イベントには`status`、`reason`が、コード確認イベントには`code_tried`、`status`が、最終ステータスイベントには`reason`が含まれます。報告する理由がない場合(例: `EMAIL_VERIFICATION_APPROVED`)は`null`になります。 properties: status: type: string reason: type: string nullable: true code_tried: type: string fee: type: number matches: type: array description: >- このメールアドレスで見つかった一致です。各一致には`source`があります。`session`（アプリケーション内の別の認証セッションが同じメールアドレスで一致したもの。`session_id`/`session_number`/`vendor_data`/`verification_date`とともに返されます）または`list_entry`（メールアドレスが組織で管理する許可リスト/ブロックリストに登録されているもの。`/management-api/lists/overview`を参照）のいずれかです。セッション間の一致は異なる`vendor_data`を使用し、上限は5件です。 items: type: object properties: session_id: type: string format: uuid nullable: true session_number: type: integer nullable: true vendor_data: type: string nullable: true verification_date: type: string format: date-time nullable: true email: type: string format: email status: type: string nullable: true is_blocklisted: type: boolean api_service: type: string nullable: true source: type: string enum: - session - list_entry description: >- この一致の発生元です。`session`は、アプリケーション内の別の認証セッションがこの値で一致したことを意味します。`list_entry`は、組織が管理するリスト（許可リスト/ブロックリスト）に対してこの値がヒットしたことを意味します。これらのリストの管理方法については、`/management-api/lists/overview`のManagement APIのリスト概要を参照してください。 email_intelligence: allOf: - $ref: '#/components/schemas/EmailIntelligence' description: メールインテリジェンスのシグナル。このアドレスに対してメールインテリジェンスのアドオンが実行された場合にのみ含まれます。 email_social: allOf: - $ref: '#/components/schemas/EmailSocialFootprint' description: 住所のソーシャルフットプリント。この住所に対してソーシャルフットプリントアドオンが実行された場合にのみ含まれます。 poa_verifications: type: array nullable: true description: >- **住所証明(POA)レポートの配列**。常にJSON配列であり、単一の`poa`オブジェクトになることはありません。少なくとも1つのPOAステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、書類ファイルのURL、発行者、日付、解析済みの住所、`warnings[]`を含みます。 items: type: object properties: node_id: type: string description: ワークフローグラフ内のこのPOAステップの一意の識別子。 status: type: string description: >- この住所証明ステップの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 enum: - Not Finished - Approved - Declined - In Review - Resub Requested document_file: type: string format: uri description: 住所証明書類のURL issuing_state: type: string description: 発行国の2文字の国コード document_type: type: string description: 住所証明書類の種類 document_subtype: type: string nullable: true description: >- `document_type`内での住所証明書類のより具体的な分類で、検出された場合に設定されます。それ以外の場合は`null`です。 document_language: type: string description: 書類の言語コード document_metadata: type: object properties: file_size: type: integer description: 書類のサイズ content_type: type: string description: 書類のコンテンツタイプ creation_date: type: string format: date description: 書類の作成日 modified_date: type: string format: date description: 書類の更新日 overlay_manipulation: type: object nullable: true description: >- オーバーレイテキストによる改ざんが疑われる場合のPDFフォレンジック分析。オーバーレイによる改ざんの証拠が見つからなかった場合、または書類がPDFでなかった場合はnullです。 properties: detected: type: boolean description: オーバーレイテキストによる改ざんの痕跡が検出されたかどうかです。 analyzed: type: boolean description: PDFを解析できたかどうか。 signals: type: array items: type: string description: >- 検出されたフォレンジックシグナル（duplicate_font_subsetやglyph_fragmentationなど）。 manipulated_regions: type: array description: 改ざんが疑われる領域（PDFページ座標）。 items: type: object properties: page: type: integer x: type: number 'y': type: number width: type: number height: type: number page_width: type: number page_height: type: number creator: type: string nullable: true description: 書類のメタデータに記録された作成元アプリケーション。 producer: type: string nullable: true description: PDFメタデータに記録された作成ソフトウェア(Producer)。 software: type: string nullable: true description: ファイルのメタデータに記録された編集・加工ソフトウェア。 encryption: type: string nullable: true description: 暗号化されている場合の、書類の暗号化方式。 is_signed: type: boolean nullable: true description: PDFにデジタル署名が付与されているかどうか。 is_tampered: type: boolean nullable: true description: 署名検証により、ファイルが署名後に変更されたことが示されているかどうかです。 signature_info: type: object nullable: true description: デジタル署名が存在する場合、その詳細。 exif_original_date: type: string nullable: true description: 画像アップロードにおけるEXIFのオリジナル撮影日時。 exif_digitized_date: type: string nullable: true description: 画像アップロードにおけるEXIFのデジタル化日時。 processed_by_known_editor: type: boolean nullable: true description: ファイルのメタデータが、既知の書類編集ソフトによる処理を示しているかどうか。 has_different_creation_mod_date: type: boolean nullable: true description: 作成日と更新日が異なるかどうか。改ざんの一般的な兆候です。 description: >- アップロードされた住所証明書類から抽出されたファイルフォレンジックのメタデータ。常に以下のキーを含みます(該当しない場合、たとえばPDFのEXIF日付などは値が`null`になります)。メタデータを抽出できなかった場合は`null`です。 nullable: true issuer: type: string description: 書類発行者の名称 issue_date: type: string format: date description: 書類の発行日 expiration_date: type: string format: date nullable: true description: 書類の有効期限（利用可能な場合） poa_address: type: string description: 住所証明書類から取得した生の住所 poa_formatted_address: type: string description: 住所証明書類から整形された住所 poa_parsed_address: type: object properties: address_type: type: string description: 住所の種類（Street、Avenueなど） street_1: type: string description: 主たる住所(番地) street_2: type: string nullable: true description: 住所（2行目） city: type: string description: 都市名 region: type: string description: 地域または州の名称 country: type: string description: 2文字の国コード postal_code: type: string description: 郵便番号 document_location: type: object properties: latitude: type: number description: 緯度 longitude: type: number description: 経度座標 name_on_document: type: string nullable: true description: POA書類から抽出された口座名義人または宛名の氏名で、氏名照合に使用されます。氏名を抽出できなかった場合は`null`です。 name_match_score_expected_details: type: number nullable: true description: >- `name_on_document`と、セッション作成時に指定された想定氏名との類似度スコア(0〜100)。いずれかが欠けている場合は`null`です。 name_match_score_id_verification: type: number nullable: true description: >- `name_on_document`と、本人確認ステップで抽出された氏名との類似度スコア(0〜100)。いずれかが欠けている場合は`null`です。 expected_details_address: type: string nullable: true description: 検証用の想定される未加工の住所 expected_details_formatted_address: type: string nullable: true description: 検証用の想定される整形済み住所 expected_details_parsed_address: type: object description: 検証用の想定される解析済み住所の詳細 extra_fields: type: object description: 書類から抽出された追加の銀行情報および連絡先情報。 properties: bank_account_number: type: string nullable: true bank_iban: type: string nullable: true bank_sort_code: type: string nullable: true bank_routing_number: type: string nullable: true bank_swift_bic: type: string nullable: true bank_branch_name: type: string nullable: true bank_branch_address: type: string nullable: true document_phone_number: type: string nullable: true additional_names: type: array items: type: string extra_files: type: array items: type: string format: uri description: 住所証明の追加ファイル warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID detected_codes: type: array description: >- 書類の処理済みのすべてのページで検出されたQRコードとバーコード。見つからない場合は空です。位置は特定できたもののデコードできないQRコードは`parsed_payload: null`となります。 items: $ref: '#/components/schemas/DocumentAIDetectedCode' address_validation: allOf: - $ref: '#/components/schemas/AddressValidationResult' nullable: true description: >- この住所証明に記載された住所の住所検証（Address Validation）です。住所が存在するかどうかと、書類から読み取った正規化された形式を示します（後から`poa_address`を修正しても再実行されません）。この住所証明ステップでAddress Validationアドオンが有効化され、アップロードが書類チェックを通過した場合に存在し、それ以外の場合は`null`です。 document_ai_documents: type: array nullable: true description: >- **ワークフローノードごとにグループ化されたDocument AIレポート**。常にJSON配列で、単一のオブジェクトになることはありません。少なくとも1つのDocument AIステップがデータを生成するまでは`null`です。`session_kind = user`の場合にのみ含まれます。各項目はノードグループで、集計された`status`、`node_id`、書類ごとの結果（設定したフィールドキーをキーとする抽出データ）を格納する`items[]`配列、および`warnings`を含みます。 items: type: object description: ワークフローノードごとにグループ化されたDocument AIの結果。 properties: status: type: string description: このノードのDocument AIの集約ステータスで、`items[]`から集計されます。 enum: - Approved - Declined - In Review - Not Finished node_id: type: string nullable: true description: ワークフローグラフ内のこのDocument AIステップの一意の識別子。 items: type: array items: type: object properties: uuid: type: string format: uuid node_id: type: string nullable: true description: この書類を生成したワークフローグラフのノード。 document_key: type: string description: このファイルに対応する、設定済みのDocument AI書類のキー。 original_filename: type: string nullable: true description: ユーザーがアップロードした際のファイル名。 file_size: type: integer nullable: true description: ファイルサイズ(バイト)。 file_url: type: string format: uri nullable: true description: アップロードされたファイルへの有効期間の短い署名付きリンク。 status: type: string enum: - Approved - Declined - In Review - Not Finished description: 書類ごとのDocument AIステータス。 extracted_data: type: object additionalProperties: true nullable: true description: >- Document AIが抽出した値で、設定されたフィールドの`key`をキーとします。各値は文字列、数値、または`null`です。 detected_codes: type: array description: >- 処理済みのすべてのページで検出されたQRコードとバーコード。見つからない場合は空です。位置は特定できたもののデコードできないQRコードは`parsed_payload: null`となります。 items: $ref: '#/components/schemas/DocumentAIDetectedCode' fields: type: array description: この書類に設定された抽出フィールド。 items: type: object properties: key: type: string description: '`extracted_data`のキーとして使用される固定のフィールドキー。' name: type: string description: 人が読めるフィールド名。 instruction: type: string description: モデルに提示される抽出指示。 type: type: string enum: - text - number - date description: 抽出フィールドの想定される値の型です。 required: type: boolean description: Whether this field is required. document_metadata: type: object nullable: true description: >- アップロードされた書類から抽出されたファイルフォレンジックのメタデータ(例:`is_tampered`)。何も抽出できなかった場合は`null`です。 cross_check_result: type: object nullable: true description: 抽出した書類フィールドと他のセッションデータとの照合結果。照合が実行されなかった場合は`null`です。 created_at: type: string format: date-time warnings: type: array nullable: true items: type: object description: このDocument AIノードで発生した警告ログ。 questionnaire_responses: type: array nullable: true description: >- **アンケート回答レポートの配列**。常にJSON配列であり、単一の`questionnaire`オブジェクトになることはありません。少なくとも1つのアンケートステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、アンケートのメタデータ、フォーム要素を含むセクション、ユーザーの回答を含みます。 items: type: object properties: node_id: type: string description: ワークフローグラフ内のこのアンケートステップの一意の識別子。 questionnaire_id: type: string description: アンケートの一意の識別子 title: type: string description: アンケートのタイトル description: type: string description: アンケートの説明 languages: type: array items: type: string description: 対応言語 default_language: type: string description: デフォルト言語 is_active: type: boolean description: アンケートが有効かどうか is_simple_questionnaire: type: boolean description: アンケートが単純な直線形式のフォーム(分岐グラフなし)かどうか。 questionnaire_group_id: type: string format: uuid nullable: true description: バージョンをまたいで不変のアンケートグループの識別子。 version: type: integer nullable: true description: 回答されたアンケートのバージョン番号。 published_at: type: string format: date-time nullable: true description: このアンケートのバージョンが公開された日時。 sections: type: array items: type: object properties: title: type: string nullable: true description: セクションのタイトル description: type: string nullable: true description: セクションの説明 items: type: array items: type: object properties: uuid: type: string description: アイテムの一意の識別子 value: type: string nullable: true description: アンケートのグラフ内におけるこのフォーム要素の安定したノード識別子。 element_type: type: string description: アンケート要素の種類 is_required: type: boolean description: 項目が必須かどうか title: type: string description: 項目のタイトル description: type: string nullable: true description: 項目の説明 placeholder: type: string nullable: true description: プレースホルダーテキスト choices: type: array nullable: true items: type: object properties: label: type: string value: type: string requires_text_input: type: boolean description: この選択肢で追加のテキスト入力が必要かどうか nullable: true required: - label - value description: ドロップダウンまたは単一選択要素の選択肢 max_files: type: integer description: 許可される最大ファイル数 nullable: true answer: type: object description: 項目に対して提供された回答 properties: value: type: string nullable: true text: type: string nullable: true files: type: array items: type: string nullable: true required_if: type: object nullable: true description: 特定の回答に対してのみ要素が必須となる場合の条件付き必須ルール。 repeatable_config: type: object nullable: true description: 該当する場合の、繰り返し可能な要素グループの設定。 required: - uuid - value - element_type - is_required - title status: type: string description: アンケートのステータス bank_verifications: type: array nullable: true description: >- ユーザー認証および法人確認における銀行口座認証の結果で、銀行口座認証ステップごとに1項目です。ステップが結果を生成するまでは`null`です。各項目の`method`は口座の認証方法を示します。`open_banking`（銀行へのサインイン）または`account_lookup`（口座照会）、フォールバックとしての`statement`または`microdeposits`のいずれかで、いずれの試行も評価される前に本人が銀行を使わずに続行した場合（`continued_without_bank`）は`none`です。詳細は[銀行口座認証の方法](/ja/core-technology/bank-verification/verification-methods)を参照してください。銀行口座認証は本番環境ではまだ有効化されていないため、有効化されるまで本番環境のセッションではこの値は`null`のままです。 items: $ref: '#/components/schemas/BankVerificationResult' signatures: type: array description: >- ユーザー認証および法人確認における電子署名の結果で、署名者と署名ステップごとに1項目です。ワークフローに電子署名ステップがある場合にのみ存在し、署名者がそのステップに到達するまでは空の配列です。[電子署名レポート](/ja/core-technology/electronic-signature/report-electronic-signature)を参照してください。 items: $ref: '#/components/schemas/SignatureResult' aml_screenings: type: array nullable: true description: >- **AMLスクリーニングレポートの配列**。常にJSON配列であり、単一の`aml`オブジェクトになることはありません。少なくとも1つのAMLステップがデータを生成するまでは`null`です。各項目は完全なレポートで、`node_id`、機能レベルの`status`、`total_hits`、`entity_type`、`hits[]`、`score`、`screened_data`、`is_ongoing_monitoring_enabled`、`warnings[]`を含みます。 items: $ref: '#/components/schemas/AMLScreening' ip_analyses: type: array nullable: true description: >- **デバイス・IP分析レポートの配列**。常にJSON配列であり、単一の`ip_analysis`オブジェクトになることはありません。少なくとも1つのIP分析ステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、IPおよび位置情報データ、デバイスフィンガープリント、`warnings[]`を含みます。`(node_id, ip_address, device_fingerprint)`が重複するエントリは、サーバー側で重複排除されます。 items: type: object properties: node_id: type: string description: ワークフローグラフ内のこのデバイス・IP分析ステップの一意の識別子。 status: type: string description: >- このデバイス・IP分析エントリーの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 enum: - Not Finished - Approved - Declined - In Review - Resub Requested device_brand: type: string description: 使用されたデバイスのブランド device_model: type: string description: 使用されたデバイスの機種 browser_family: type: string description: 使用されたブラウザファミリー os_family: type: string description: オペレーティングシステムのファミリー platform: type: string description: プラットフォームの種類(mobile、desktopなど) device_fingerprint: type: string nullable: true description: 一意のデバイスフィンガープリント識別子 ip_country: type: string description: IPから検出された国 ip_country_code: type: string description: IPから判定した2文字の国コード ip_state: type: string description: IPから検出された州・地域 ip_city: type: string description: IPから検出された都市 latitude: type: number description: IPの位置情報の緯度 longitude: type: number description: IP位置情報の経度座標 ip_address: type: string description: IPアドレス isp: type: string nullable: true description: インターネットサービスプロバイダー organization: type: string nullable: true description: IPに関連付けられた組織 is_vpn_or_tor: type: boolean description: IPがVPNまたはTorネットワークからのものかどうか is_data_center: type: boolean description: IPがデータセンターからのものかどうか time_zone: type: string description: IPから検出されたタイムゾーン time_zone_offset: type: string description: タイムゾーンのオフセット ip: type: object description: >- このエントリのIPジオロケーションと、本人確認書類の住所および住所証明書類の住所までの大圏距離（km）。いずれか一方の位置を特定できない場合、距離は`null`になります。 properties: location: type: object nullable: true properties: latitude: type: number example: 41.2706327 longitude: type: number example: 1.9770097 description: 座標。利用できない場合は`null`。 distance_from_id_document: type: number nullable: true example: 23.4 distance_from_poa_document: type: number nullable: true example: 12.3 id_document: type: object description: >- 身分証明書の住所から抽出された位置情報と、IPジオロケーションおよび住所証明書類の住所までの距離（km）。書類の住所をジオコーディングできなかった場合、`location`は`null`です。 properties: location: type: object nullable: true properties: latitude: type: number example: 41.2706327 longitude: type: number example: 1.9770097 description: 座標。利用できない場合は`null`。 distance_from_ip: type: number nullable: true example: 23.4 distance_from_poa_document: type: number nullable: true example: 18.7 poa_document: type: object description: >- 住所証明書類から抽出された位置情報と、IPジオロケーションおよび身分証明書の住所までの距離（km）。セッションに住所証明のステップがない場合、または住所をジオコーディングできなかった場合、`location`は`null`です。 properties: location: type: object nullable: true properties: latitude: type: number example: 41.2706327 longitude: type: number example: 1.9770097 description: 座標。利用できない場合は`null`。 distance_from_ip: type: number nullable: true example: 12.3 distance_from_id_document: type: number nullable: true example: 18.7 warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID matches: type: array description: >- このエントリーのIPアドレスまたはデバイスIDについて見つかったセッション間の一致。各一致は、アプリケーション内で同じ値を共有する別の認証セッション（`source`は常に`session`）であり、常に現在のセッションとは異なるベンダーユーザー/`vendor_data`に属します。一致はコレクターごとに最大5件です（`device_fingerprint`はそれぞれ個別に上限が設定された2つのコレクターの合計のため、最大10件になる場合があります）。すべての項目に`match_source`、`confidence`、`match_mode`、`device_info`、`location_info`が含まれ、`recovery_similarity`、`tls_ja4_corroborated`、`recovery_gate_reason`のキーは`match_source`が`recovered_high`の場合にのみ存在します。 items: type: object additionalProperties: false properties: session_id: type: string format: uuid description: 一致したセッションのセッションID。 session_number: type: integer description: 一致したセッションの連番。 vendor_data: type: string nullable: true description: 該当するセッションの`vendor_data`です。常に現在のセッションのベンダーユーザーとは異なります。 verification_date: type: string format: date-time nullable: true description: 一致したセッションの作成日（`YYYY-MM-DDTHH:MM:SSZ`）。 match_type: type: string enum: - ip_address - device_fingerprint description: 一致がIPアドレスとデバイスフィンガープリントのどちらによるものか match_source: type: string enum: - ip_address - persistent_id - legacy_fp - recovered_high description: >- この一致がどのように得られたか。`ip_address`（共有IPアドレス。ネットワーク上の同居を示すもので、デバイスの同一性を主張するものではありません）、`persistent_id`（保存された永続的なデバイス識別子との完全一致）、`legacy_fp`（従来の`didit-fp-*`デバイスフィンガープリントハッシュ）、または`recovered_high`（高信頼度のファジーなフィンガープリント復元によるヒット）のいずれかです。信頼度の低い復元候補はリスク警告としてのみ表示され、この配列に含まれることはありません。 matched_value: type: string nullable: true description: >- 一致した値。共有IPアドレス、永続的なデバイス識別子またはレガシーのフィンガープリントハッシュ、`recovered_high`の場合は復元されたデバイスのUUIDです。 status: type: string description: 一致したセッションのライフサイクルステータス。 is_blocklisted: type: boolean description: 一致した値がブロックリストに登録されているかどうか。デバイス/IPの一致では、現在は常に`false`です。 api_service: type: string nullable: true description: 一致したセッションのスタンドアロンAPIサービス。ワークフローセッションでは`null`です。 source: type: string enum: - session description: >- デバイス/IPの一致では常に`session`です。一致はすべて、お使いのアプリケーション内の別の認証セッションです。 device_info: type: object description: 一致したセッションで観測されたデバイスの詳細です。 properties: device_brand: type: string nullable: true device_model: type: string nullable: true browser_family: type: string nullable: true os_family: type: string nullable: true platform: type: string nullable: true device_fingerprint: type: string nullable: true location_info: type: object description: 一致したセッションで観測されたネットワークおよび位置情報の詳細。 properties: ip_address: type: string nullable: true ip_country: type: string nullable: true ip_country_code: type: string nullable: true ip_state: type: string nullable: true ip_city: type: string nullable: true is_vpn_or_tor: type: boolean is_data_center: type: boolean confidence: type: number minimum: 0 maximum: 1 description: >- サーバー側の識別信頼度で、`1 - P(false positive)`として算出されます。決定論的な一致（`persistent_id`、またはハードウェアに根差した`recovered_high`）は`1.0`、`legacy_fp`は`0.5`、`ip_address`（同一ロケーションのみ）は`0.0`、確率的な復元一致には裏付けに応じて調整された`1.0`未満の値が設定されます（TLS JA4フィンガープリントとIPの国が独立して一致する場合は高くなります）。 match_mode: type: string enum: - deterministic - probabilistic - co_occurrence description: >- 一致のエビデンス区分です。`deterministic`（物理デバイス間で衝突することのない、保存済みまたはハードウェアに由来する完全一致の識別子）、`probabilistic`（曖昧なフィンガープリントのエビデンス）、`co_occurrence`（ネットワークの共有のみで、デバイスの同一性は主張しない）のいずれかです。 recovery_similarity: type: number description: >- フィンガープリント復元による一致のコサイン類似度(小数点以下4桁に丸め)。`match_source`が`recovered_high`の場合にのみ含まれます。 tls_ja4_corroborated: type: boolean description: >- 2つの観測のTLS JA4フィンガープリントが一致するかどうか。ブラウザ側では偽装できない、サーバー側で観測されるシグナルです。`match_source`が`recovered_high`の場合にのみ含まれます。 recovery_gate_reason: type: string description: >- 復旧照合が誤検知防止のハードゲートを通過した理由。`hardware_root_match`（ハードウェアに根ざしたデバイス識別子が完全一致した）、またはプローブのみの証拠を許容する設定では`exact_composite_plus__families` / `very_high_similarity_plus__families`です。`match_source`が`recovered_high`の場合にのみ含まれます。 browser_version: type: string nullable: true os_version: type: string nullable: true user_agent: type: string nullable: true description: ブラウザのユーザーエージェント文字列。 accept_language: type: string nullable: true description: ブラウザが送信した`Accept-Language`ヘッダーです。 session_identifier: type: string nullable: true description: 検証が実行されたブラウジングセッションの識別子。 session_age_ms: type: integer nullable: true description: ステップ実行時点での、そのブラウジングセッションの経過時間（ミリ秒）。 coords_accuracy: type: number nullable: true description: デバイスが報告した座標の精度半径（メートル単位）。 raw_device_data: type: object nullable: true additionalProperties: true description: このステップで収集された生のデバイスシグナル。 geolocation_checks: type: array nullable: true description: >- **位置情報検証結果の配列**。位置情報検証ステップごとに1件で、そのステップで受理された試行が入ります。位置情報検証ステップがデータを生成するまでは`null`です。同じステップの以前の試行は`geolocation_attempts`にあります。 items: $ref: '#/components/schemas/GeolocationCheck' geolocation_attempts: type: array nullable: true description: >- このセッションのすべての位置情報検証ステップにおける全試行を古い順に示します。再提出によって置き換えられた試行は含まれません。レスポンス属性で`geolocation_checks`を非表示にしているワークフローでは、このリストも非表示になります。 items: $ref: '#/components/schemas/GeolocationAttempt' database_validations: type: array nullable: true description: >- **データベース検証レポートの配列**：常にJSON配列であり、単一の`database_validation`オブジェクトになることはありません。少なくとも1つのDB検証ステップがデータを生成するまでは`null`です。各要素は完全なレポートで、`node_id`、機能レベルの`status`、`screened_data`、サービスごとの`validations[]`（それぞれに登録機関の`source_data`を含む）、`warnings[]`を含みます。`screened_data`と`source_data`のフィールドは国によって異なります。 **ARG（アルゼンチン）**：screened_data: {document_number, selfie, gender, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name, date_of_birth, date_of_death, tax_id, tax_id_type, face_match_score, sit_1_since, banks, last_position, highest_position, rejected_checks}。RENAPERの生体顔照合による検証を使用します。書類に性別が記載されていない場合（運転免許証など）、性別は顔分析または名から自動的に推定されます。 **BOL（ボリビア）**：screened_data: {document_number, date_of_birth, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender} **BRA（ブラジル）**：screened_data: {tax_number, first_name, last_name, date_of_birth}。CPFの照合に成功した場合、source_dataには常に{identification_number, first_name, last_name, date_of_birth, lgpd_minor, minor_under_18, minor_under_16}が含まれます。成人の照会に成功した場合、これらのフラグはfalseに設定されます。Receita FederalのConsulta CPFサービスは、LGPDにより開示が保留されたデータとともにHTTP 422（18歳未満の未成年者）または451（16歳未満）を返す場合があります。その場合、source_dataでは該当する未成年者フラグがtrueに設定され、上流のHTTPステータスが含まれ、フィールドレベルの検証はno_matchになります。コードの全一覧は、Database Validation Outcome Codesリファレンスのブラジルのセクションを参照してください。 **CHL（チリ）**：screened_data: {personal_number, first_name, last_name, date_of_birth}。source_data: {identification_number, first_name, last_name, date_of_birth, gender} **COL（コロンビア）**：screened_data: {document_number, document_type, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name, date_of_birth, document_type} **CRI（コスタリカ）**：screened_data: {personal_number, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name} **DOM（ドミニカ共和国）**：screened_data: {personal_number}。source_data: {identification_number}（有効/無効のみを返します） **ECU（エクアドル）**：screened_data: {personal_number, first_name, last_name}。source_data: {identification_number, first_name, last_name, street, formatted_address, gender, nationality, education, marital_status, spouse, mother_name, father_name, profession} **ESP（スペイン）**：screened_data: {personal_number, document_type, expiration_date, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name, document_type, expiration_date} **GTM（グアテマラ）**：screened_data: {document_number, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name} **HND（ホンジュラス）**：screened_data: {document_number, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name} **MEX（メキシコ）**：screened_data: {personal_number (CURP), first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender, nationality, curp_status, state_of_birth, doc_probatorio, registration_year, registration_state, registration_municipality, num_acta, crip, issuing_state_code, foreign_registry_number, folio_carta, folio_certificado}。RENAPOの住民登録を使用します。MEXでは、追加の個別検証として、別途INEの有効性確認サービスも利用できます。 **PAN（パナマ）**：screened_data: {personal_number, selfie}。source_data: {identification_number}。SIBの生体認証による検証を使用します。 **PER（ペルー）**：screened_data: {personal_number (DNI), first_name, last_name}。source_data: {identification_number, first_name, last_name, paternal_name, maternal_name, verification_number, verification_letter} **PRY（パラグアイ）**：screened_data: {document_number, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name} **SLV（エルサルバドル）**：screened_data: {document_number, date_of_birth, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name} **URY（ウルグアイ）**：screened_data: {personal_number, date_of_birth, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name} **VEN（ベネズエラ）**：screened_data: {document_number, first_name, last_name}。source_data: {identification_number, first_name, last_name, full_name, gender, date_of_birth, document_type} items: type: object properties: node_id: type: string description: ワークフローグラフ内のこのデータベース検証ステップの一意の識別子。 issuing_state: type: string description: >- 政府・登記機関のデータソースを照会した国のISO 3166-1 alpha-3コード(例: `BRA`、`MEX`、`ESP`、`NGA`、`IDN`)。データベース検証は、南北アメリカ、ヨーロッパ、アフリカ、中東、アジア太平洋の60+か国に加え、複数の国にまたがるグローバルなソースにも対応しています。対応範囲は定期的に拡大するため、この値は固定のenumではなく、今後も値が追加される集合として扱ってください。 validation_type: type: string enum: - one_by_one - two_by_two - not_enabled description: >- 結果の裏付け方法：`one_by_one`（単一サービスの結果）、`two_by_two`（2つ以上の異なるサービスがそれぞれ独立して識別番号に完全一致）、または`not_enabled`（どのサービスも利用可能な一致を得られなかった場合に保存）。値が`null`になることはありません。生体認証専用の2x2検証モードは現在`ECU`と`PER`で利用できます。 screened_data: type: object description: >- 検証に使用する入力データです。フィールドは国によって異なります。国別の形式については、データベース検証のドキュメント(`/core-technology/database-validation/overview`)を参照してください。 properties: last_name: type: string first_name: type: string tax_number: type: string description: ブラジル：CPF（11桁） personal_number: type: string description: >- チリ: RUT、DOM: Cédula（11桁）、ECU: Cédula（10桁）、ESP: DNI/NIE、MEX: CURP（18文字）、PER: DNI（8桁）、URY: CI document_number: type: string description: >- ARG: DNI、BOL: CI、COL: Cédula、GTM: DPI、HND: DNI、PAN: Cédula、PRY: CI、SLV: DUI、VEN: Cédula date_of_birth: type: string format: date document_type: type: string description: COL:CC/CE/TI/NIT、ESP:ID/PASSPORT expiration_date: type: string format: date description: ESPでは必須 validations: type: array description: >- 検証ペイロードを返した登記サービスごとに1エントリー。各エントリーはサービス（`service_id`、`service_name`）を識別し、フィールドごとの`validation`比較、報告された場合はサービスの`outcome_code` / `outcome_detail`、および`source_data`内の正規化された登記レコードを含みます。 items: type: object properties: service_id: type: string description: この検証結果を生成したレジストリサービスの識別子。 example: bra_cpf service_name: type: string description: 登記サービスの人が読める名前。 example: Brazil - CPF status check validation: type: object description: フィールド検証の結果です。 properties: full_name: type: string description: '氏名の照合結果（例: ''full_match''、''partial_match''、''no_match''）。' date_of_birth: type: string description: 生年月日の照合結果。 identification_number: type: string description: 識別番号の照合結果。 outcome_code: type: string nullable: true description: >- 登記照会の機械可読な結果（例: `MATCH`、`NO_MATCH`、`PARTIAL_MATCH`、`INCONCLUSIVE`、ソース固有のコード）。サービスが結果を報告した場合に含まれます。 outcome_detail: type: string nullable: true description: '`outcome_code`を人が読める形で説明したもの（サービスから提供される場合）。' source_data: type: object description: >- 政府データベースから返されたデータ。共通フィールド:identification_number、first_name、last_name、full_name、date_of_birth、gender。国ごとの追加フィールド:BRAでは、CPFの照合に成功した場合は常にlgpd_minor、minor_under_18、minor_under_16が含まれます。また、LGPDに基づいてCPFデータが開示されない場合(HTTP 422/451)は、上流のHTTPステータスも含まれます。ECUではstreet、formatted_address、nationality、education、marital_status、spouse、mother_name、father_name、professionが追加されます。PERではpaternal_name、maternal_name、verification_number、verification_letterが追加されます。ESPではdocument_type、expiration_dateが追加されます。VEN/COLではdocument_typeが追加されます。 additionalProperties: true errors: type: array description: >- 検証中に登記サービスから返されたエラー。それぞれに、エラーを生成した`service_id`のタグが付きます。**エラーがない場合、このキー自体が省略されます。** items: type: object description: >- 上流サービスのエラーオブジェクトをそのまま展開したもの（キーはサービスによって異なり、一般的にはメッセージやコード、プロバイダー固有の詳細を含みます）に、エラーが発生したサービスを示す`service_id`を加えたもの。 properties: service_id: type: string nullable: true description: エラーが発生したレジストリサービスの識別子。 additionalProperties: true match_type: type: string enum: - no_match - partial_match - full_match nullable: true description: 照会したサービス全体での総合的な照合結果。検証が評価されるまでは`null`です。 status: type: string description: >- このデータベース検証の機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 enum: - Not Finished - Approved - Declined - In Review - Resub Requested warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID description: データベース検証に関する警告。 database_validation_not_performed_reason: type: object nullable: true additionalProperties: true description: >- 設定済みのデータベース検証で結果が得られなかった理由で、`{code, message}`とコンテキストフィールドで表されます。ステップを含むワークフローで`database_validations`が`null`の場合にのみ存在するため、「登記機関の情報と一致した」場合と「何も実行されなかった」場合を区別できます。それ以外の場合は`null`です。 properties: code: type: string description: 安定した機械可読の理由。 message: type: string description: 人が読める説明文。 reviews: type: array items: type: object properties: user: type: string description: >- レビューを実行した者です。通常はコンソールのレビュアーの識別子（メールアドレス）ですが、APIキーで行われたステータス更新では値が`"API Client"`、実行者を特定できなかった場合は`"Unknown"`になります。そのため、このフィールドをメールアドレスとして解析しないでください。 new_status: type: string comment: type: string created_at: type: string format: date-time assignee: type: object nullable: true description: セッションが割り当てられているConsoleのレビュアー。誰も担当していない場合は`null`です。 properties: email: type: string format: email assigned_at: type: string format: date-time nullable: true waiting_since: type: string format: date-time nullable: true description: >- セッションがレビュー待ちになった日時。セッションが`In Review`で、かつアプリケーションにレビュー期限が設定されている場合を除き`null`です。 sla_due_at: type: string format: date-time nullable: true description: レビューの期限。セッションが`In Review`で、かつアプリケーションにレビュー期限が設定されている場合を除き`null`です。 created_at: type: string format: date-time description: セッションが作成された日時(ISO 8601、UTC)。 expires_at: type: string format: date-time nullable: true description: >- このセッションの有効期限が切れる予定の日時です。作成時に有効期限が設定された場合(または`Approved`ステータスによってKYCの有効期限の計算がトリガーされた時点で)、ユーザー認証 (KYC)セッションに設定されます。有効期限が設定されていないセッション、および有効期限を使用しない種類(例:`expires_at`を一度も受け取っていない法人確認 (KYB)セッション)では`null`です。 registry_checks: type: array nullable: true description: >- 法人登記チェック。`session_kind = business`の場合にのみ含まれます。各項目は法人登記のペイロード全体をラップします。 items: type: object description: >- 法人登記チェック1件。所有構造と警告で補強された法人登記ペイロード全体です。`session_kind = business`の場合にのみ存在します。 properties: status: type: string description: 機能のライフサイクルステータス。 node_id: type: string nullable: true data_resolved: type: boolean company: type: object description: 企業の完全な登記ペイロード（登記レコードに、ユーザーが提供したデータやコンソールで編集されたデータを統合したもの）。 properties: uuid: type: string format: uuid node_id: type: string nullable: true status: type: string registry_status: type: string nullable: true data_resolved: type: boolean company_name: type: string registration_number: type: string nullable: true country_code: type: string description: '設立国（ISO 3166-1 alpha-2、例: `GB`、`DE`、`US`）。' region: type: string nullable: true description: '該当する場合のISO 3166-2地域区分コード（例: 米国の州を表す`CA`、`NY`）。' company_type: type: string nullable: true incorporation_date: type: string format: date nullable: true registered_address: type: string nullable: true tax_number: type: string nullable: true risk_level: type: string enum: - LOW - MEDIUM - HIGH nullable: true verification_status: type: string nullable: true is_from_registry: type: boolean fetch_status: type: string nullable: true alternative_names: type: string nullable: true description: 報告されている場合の、別名、商号、旧社名、または原語表記の企業名（テキスト）です。 nature_of_business: type: string nullable: true registered_capital: type: string nullable: true registered_capital_amount: type: string format: decimal nullable: true description: >- 登録資本金・株式資本の金額を10進数の文字列で表したもの（例: `"100.00"`）。登記申告書から解析されます。取得できない場合は`null`です。 registered_capital_currency: type: string nullable: true description: >- `registered_capital_amount`のISO 4217通貨コード（例: `"GBP"`）。取得できない場合は`null`です。 website: type: string nullable: true email: type: string format: email nullable: true phone: type: string nullable: true legal_entity_identifier: type: string nullable: true location_of_registration: type: string nullable: true vat_number: type: string nullable: true description: EUのVAT番号。ホスト型の登記ステップで収集された場合、またはその後に編集された場合に設定されます。 vat_validation_status: type: string enum: - valid - invalid - format_valid - invalid_format - could_not_validate - not_applicable description: >- 登記の送信時に、VAT番号（ない場合は`tax_number`）を検証した結果。`valid` / `invalid`：その国の公式登記（EU VIES、ノルウェー、スイス、ブラジル、コロンビア、コスタリカ、エクアドル、パラグアイ。ポーランドは国内のVAT登録簿でも判定）によって判定されます。`format_valid` / `invalid_format`：照会できる登記がない場合に、その国の形式およびチェックディジットのルールによって判定されます。`could_not_validate`：登記を利用できませんでした。`not_applicable`：番号がない、登記もルールもない国である、またはサンドボックスのセッションです。 vat_validated_number: type: string nullable: true description: >- 確認された番号で、ソース側で認識されている形式のもの（例: フランスのSIRENやオランダのRSINから導出されたVAT番号）。確認が実行されなかった場合は`null`です。 vat_validation_source: type: string nullable: true enum: - eu_vies - pl_vat_white_list - no_brreg - ch_uid_register - br_receita_federal - co_rues - cr_hacienda - ec_sri - py_dnit - format_rules - null description: >- `vat_validation_status`を決定したソース。公式の登記簿、または`format_rules`です。チェックが実行されなかった場合は`null`です。 vat_validated_name: type: string nullable: true description: >- 番号を検証したソースに登録されている名義（ソースが開示している場合）。ステータスが`valid`の場合にのみ設定されます。 vat_validated_address: type: string nullable: true description: >- 番号を検証した情報源に登録されている住所（情報源が開示している場合）。ステータスが`valid`の場合にのみ設定されます。 vat_checked_at: type: string format: date-time nullable: true description: チェックの日時。チェックが実行されなかった場合は`null`です。 financial_summary: type: object nullable: true officers: type: array items: type: object properties: uuid: type: string format: uuid name: type: string designation: type: string nullable: true role: type: string nullable: true nationality: type: string nullable: true is_active: type: boolean kyc_status: type: string enum: - Approved - Declined - Pending nullable: true kyc_session_url: type: string format: uri nullable: true first_name: type: string nullable: true description: 登記機関が明示的に報告した場合の名。氏名からは推測されません。 last_name: type: string nullable: true description: 登記簿で明示的に報告されている場合の姓。 address: type: string nullable: true description: 登記簿に記載されている役員の住所。 appointment_date: type: string nullable: true description: 役員の就任日。 format: date termination_date: type: string nullable: true description: 役職の終了日（報告されている場合）。 format: date date_of_birth: type: string nullable: true description: 登記で報告された完全な生年月日。生年または生年月のみが判明している場合はnullです。 format: date date_of_birth_year: type: integer nullable: true minimum: 1 maximum: 9999 description: 登記所が報告した生まれ年。完全な日付が取得できない場合も含みます。 date_of_birth_month: type: integer nullable: true minimum: 1 maximum: 12 description: 登記所が報告した生まれ月。年のみ判明している場合はnullです。 beneficial_owners: type: array items: type: object properties: uuid: type: string format: uuid name: type: string first_name: type: string nullable: true last_name: type: string nullable: true entity_type: type: string enum: - person - company roles: type: array items: type: string ownership_min_shares: type: string nullable: true description: >- 登記簿が報告する所有比率の下限。自由形式の文字列（例: `"25.00"`、`"50"`）です。解析済みの数値には`effective_ownership_percent`を使用してください。 ownership_max_shares: type: string nullable: true description: >- 登記機関が報告した所有比率の上限値。自由形式の文字列です。解析済みの数値が必要な場合は`effective_ownership_percent`を使用してください。 is_active: type: boolean kyc_status: type: string enum: - Approved - Declined - Pending nullable: true kyc_session_url: type: string format: uri nullable: true effective_ownership_percent: type: number nullable: true company_name: type: string nullable: true registration_number: type: string nullable: true country_of_birth: type: string nullable: true email: type: string nullable: true nationality: type: string nullable: true designation: type: string nullable: true voting_min_shares: type: string nullable: true voting_max_shares: type: string nullable: true date_of_birth: type: string nullable: true description: 報告されている場合の完全な生年月日。 format: date appointment_date: type: string nullable: true description: 報告されている場合の任命日。 format: date shareholding: $ref: '#/components/schemas/KYBRegistryShareholding' addresses: type: array nullable: true description: 登記簿に記載されているすべての住所を、1つの標準形式で示します。記載がない場合はnullです。 items: $ref: '#/components/schemas/KYBRegistryAddress' industries: type: array nullable: true description: 登記上で会社が分類されている事業活動。単一の正規化された形式です。登記に記載がない場合はnullです。 items: $ref: '#/components/schemas/KYBRegistryIndustry' accounts: type: object nullable: true additionalProperties: true description: >- 登記申告の日付（取得できる場合）。年次報告書と株主総会にはlast_annual_return_dateとlast_agm_dateを使用し、これらは財務諸表とは区別されます。 registry_data: $ref: '#/components/schemas/KYBRegistryData' user_provided_data: type: object description: エンドユーザーが確認または編集したデータ。 confirmed_by_user_at: type: string format: date-time nullable: true last_console_edit_at: type: string format: date-time nullable: true is_editable: type: boolean ownership: $ref: '#/components/schemas/KYBRegistryOwnership' registry_tier: type: string nullable: true description: >- ワークフローが指定した登記のレベル: `basic`、`shareholders`または`ubo`。`ownership.tier_requested`にも含まれます。 registry_tier_delivered: type: string nullable: true description: 登記機関が提供し、請求対象となるレベル。`ownership.tier_delivered`にも含まれます。 registry_ownership_status: type: string nullable: true description: >- `not_requested`、`pending`、`delivered`、`not_held`または`unavailable`。`ownership.status`にも含まれます。 registry_monitoring: type: object nullable: true description: その企業の最新の登記モニターです。存在しない場合は`null`です。 properties: uuid: type: string format: uuid status: type: string unavailable_reason: type: string nullable: true enrolled_at: type: string format: date-time nullable: true cancelled_at: type: string format: date-time nullable: true last_bill_date: type: string format: date nullable: true next_bill_date: type: string format: date nullable: true last_event_at: type: string format: date-time nullable: true events_count: type: integer watched_fields: description: モニターが監視する企業フィールド。 ownership_structure: $ref: '#/components/schemas/KYBOwnershipStructure' warnings: type: array items: type: object key_people_checks: type: array nullable: true description: >- 主要人物チェックの集約。`session_kind = business`の場合にのみ含まれます。各項目は2つのバケットからなる形式（`registry`、`submitted`、`ubo_kyc_summary`）を使用します。 items: type: object description: >- 企業の役員とUBOに対する集約チェック。`registry` / `submitted`の形式を使用します。session_kind = businessの場合にのみ含まれます。 properties: status: type: string node_id: type: string nullable: true registry: type: object description: 法人登記の照会で見つかった関係者。 properties: officers: type: array description: >- 登記チェックで判明した役員。各役員には、その役員のために生成された子KYCセッションおよびAMLスクリーニングのステータスが付加されます。 items: type: object properties: uuid: type: string format: uuid name: type: string description: 登記簿に記録されている役員の氏名。 designation: type: string nullable: true description: '登記上の自由記述の役職名（例: `Director`、`Company Secretary`）。' role: type: string enum: - director - non_executive_director - secretary - chairman - ubo - shareholder - representative - founder - legal_advisor - authorized_signatory - trustee - beneficiary - settlor - protector - company_officer - investor - other description: 正規化された役員の役割。 nationality: type: string nullable: true appointment_date: type: string nullable: true description: 役員の就任日。 format: date termination_date: type: string nullable: true description: 役職の終了日（報告されている場合）。 format: date is_active: type: boolean address: type: string nullable: true description: 登記簿に記載されている役員の住所。 aml_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested nullable: true description: >- この役員に対して実行されたAMLスクリーニングのステータスです。AMLスクリーニングが実行されていない場合は`null`です。 kyc_status: type: string enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User nullable: true description: >- この役員に対して生成された子KYCセッションの、生のライフサイクルステータス。セッションステータスの完全なenumです（Approved/Declined/Pendingに絞り込んだセットではありません）。子KYCセッションが存在しない場合は`null`です。 kyc_session_url: type: string format: uri nullable: true description: 子KYCセッションの共有可能なURL。子セッションが存在しない場合は`null`。 kyc_session_id: type: string format: uuid nullable: true description: >- 子KYCセッションのセッションID。同じ判定エンドポイントに渡すと、その人物の完全なKYCレポートを取得できます。子セッションが存在しない場合は`null`です。 verification_workflow_type: type: string nullable: true description: >- 子セッションのワークフローのベースワークフロータイプです（例: `kyc`）。グラフベースのワークフローの場合、または子セッションが存在しない場合は`null`です。 verification_workflow_id: type: string format: uuid nullable: true description: 子セッションが使用するワークフローID。子セッションが存在しない場合は`null`です。 verification_workflow_label: type: string nullable: true description: 子セッションのワークフローの人が読めるラベル。未設定の場合は`null`です。 verification_workflow_features: type: array nullable: true description: >- 子検証セッションの機能ごとの進捗。例：`[{"feature": "ID_VERIFICATION", "status": "Approved"}]`。子セッションに解決可能な機能リストがない場合は`null`。 items: type: object properties: feature: type: string description: '機能の表示名（例: `ID_VERIFICATION`、`LIVENESS`、`AML`）。' status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: 子セッション内の機能レベルのステータスです。 didit_internal_id: type: string nullable: true description: >- 子セッションの背後にある認証済み個人の不変の内部識別子。セッション間の紐付けに役立ちます。子セッションが存在しない場合、またはユーザーがまだ特定されていない場合は`null`です。 kyc_document_type: type: string nullable: true description: >- 子KYCセッションで提示された書類種別(例: `P`、`ID`、`DL`)。子セッションに本人確認の結果が出るまでは`null`。 kyc_nationality: type: string nullable: true description: 子KYCセッションの書類から抽出された国籍。取得できるまでは`null`です。 kyc_liveness_passed: type: boolean nullable: true description: >- 子KYCセッションのライブネスチェックに合格したかどうか。ライブネスチェックが実行されていない場合は`null`です。 kyc_verified_at: type: string format: date-time nullable: true description: >- 子KYCセッションが`Approved`に到達した日時。子セッションがそれ以外のステータスの間は`null`。 kyc_aml_categories: type: object nullable: true description: 対象者のAMLヒットから算出したカテゴリごとの概要。ヒットがない場合は`null`。 properties: sanctions: type: string enum: - match - clear pep: type: string enum: - match - clear adverse_media: type: string enum: - match - clear warnings: type: string enum: - match - clear kyc_notification_sent_at: type: string nullable: true description: >- この人物の子セッションに対して最後に送信された認証招待通知のISO 8601タイムスタンプ。送信されていない場合は`null`です。 first_name: type: string nullable: true description: 登記機関が明示的に報告した場合の名。氏名からは推測されません。 last_name: type: string nullable: true description: 登記簿で明示的に報告されている場合の姓。 date_of_birth: type: string nullable: true description: 登記で報告された完全な生年月日。生年または生年月のみが判明している場合はnullです。 format: date date_of_birth_year: type: integer nullable: true minimum: 1 maximum: 9999 description: 登記所が報告した生まれ年。完全な日付が取得できない場合も含みます。 date_of_birth_month: type: integer nullable: true minimum: 1 maximum: 12 description: 登記所が報告した生まれ月。年のみ判明している場合はnullです。 beneficial_owners: type: array description: >- 登記照会で判明した実質的支配者です。それぞれについて、生成された子KYCセッションおよびAMLスクリーニングのステータスが付加されています。 items: type: object properties: uuid: type: string format: uuid name: type: string description: 実質的支配者の氏名（法人のUBOの場合は会社名）。 first_name: type: string nullable: true last_name: type: string nullable: true date_of_birth: type: string nullable: true description: 報告されている場合の完全な生年月日。 format: date country_of_birth: type: string nullable: true email: type: string nullable: true company_name: type: string nullable: true registration_number: type: string nullable: true entity_type: type: string enum: - person - company nationality: type: string nullable: true designation: type: string nullable: true roles: type: array description: 'この所有者が持つ役割名。例: `["ubo", "shareholder"]`。' items: type: string ownership_min_shares: type: string nullable: true description: >- 登記簿が報告する所有比率の下限。自由形式の文字列（例: `"25"`、`"25-50%"`）です。解析済みの数値には`effective_ownership_percent`を使用してください。 ownership_max_shares: type: string nullable: true description: >- 登記機関が報告した所有比率の上限値。自由形式の文字列です。解析済みの数値が必要な場合は`effective_ownership_percent`を使用してください。 is_active: type: boolean aml_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested nullable: true description: >- この実質的支配者に対して実行されたAMLスクリーニングのステータスです。AMLスクリーニングが実行されていない場合は`null`です。 kyc_status: type: string enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User nullable: true description: >- この実質的支配者に対して生成された子KYCセッションの、生のライフサイクルステータス。セッションステータスの完全なenumです（Approved/Declined/Pendingに絞り込んだセットではありません）。子KYCセッションが存在しない場合は`null`です。 kyc_session_url: type: string format: uri nullable: true description: 子KYCセッションの共有可能なURL。子セッションが存在しない場合は`null`。 kyc_session_id: type: string format: uuid nullable: true description: >- 子KYCセッションのセッションID。同じ判定エンドポイントに渡すと、その人物の完全なKYCレポートを取得できます。子セッションが存在しない場合は`null`です。 verification_workflow_type: type: string nullable: true description: >- 子セッションのワークフローのベースワークフロータイプです（例: `kyc`）。グラフベースのワークフローの場合、または子セッションが存在しない場合は`null`です。 verification_workflow_id: type: string format: uuid nullable: true description: 子セッションが使用するワークフローID。子セッションが存在しない場合は`null`です。 verification_workflow_label: type: string nullable: true description: 子セッションのワークフローの人が読めるラベル。未設定の場合は`null`です。 verification_workflow_features: type: array nullable: true description: >- 子検証セッションの機能ごとの進捗。例：`[{"feature": "ID_VERIFICATION", "status": "Approved"}]`。子セッションに解決可能な機能リストがない場合は`null`。 items: type: object properties: feature: type: string description: '機能の表示名（例: `ID_VERIFICATION`、`LIVENESS`、`AML`）。' status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: 子セッション内の機能レベルのステータスです。 didit_internal_id: type: string nullable: true description: >- 子セッションの背後にある認証済み個人の不変の内部識別子。セッション間の紐付けに役立ちます。子セッションが存在しない場合、またはユーザーがまだ特定されていない場合は`null`です。 kyc_document_type: type: string nullable: true description: >- 子KYCセッションで提示された書類種別(例: `P`、`ID`、`DL`)。子セッションに本人確認の結果が出るまでは`null`。 kyc_nationality: type: string nullable: true description: 子KYCセッションの書類から抽出された国籍。取得できるまでは`null`です。 kyc_liveness_passed: type: boolean nullable: true description: >- 子KYCセッションのライブネスチェックに合格したかどうか。ライブネスチェックが実行されていない場合は`null`です。 kyc_verified_at: type: string format: date-time nullable: true description: >- 子KYCセッションが`Approved`に到達した日時。子セッションがそれ以外のステータスの間は`null`。 kyc_aml_categories: type: object nullable: true description: 対象者のAMLヒットから算出したカテゴリごとの概要。ヒットがない場合は`null`。 properties: sanctions: type: string enum: - match - clear pep: type: string enum: - match - clear adverse_media: type: string enum: - match - clear warnings: type: string enum: - match - clear kyc_notification_sent_at: type: string nullable: true description: >- この人物の子セッションに対して最後に送信された認証招待通知のISO 8601タイムスタンプ。送信されていない場合は`null`です。 child_beneficial_owners: type: array description: >- 法人UBOの場合：所有する法人自体の実質的支配者で、法人登記から抽出された生のオブジェクトです。該当しない場合は空の配列です。 items: type: object effective_ownership_percent: type: number nullable: true description: >- 解析済みの数値の所有割合。上限値がある場合は上限値、ない場合は下限値です。どちらの値も解析できなかった場合は`null`です。 voting_min_shares: type: string nullable: true voting_max_shares: type: string nullable: true appointment_date: type: string nullable: true description: 報告されている場合の任命日。 format: date submitted: type: object description: 主要人物フローで企業の管理者が提出した関係者（source=USERのBusinessParty行）。 properties: parties: type: array items: type: object description: 主要人物フローを通じて企業の管理者が提出した関係者（source=USER）。 properties: uuid: type: string format: uuid entity_type: type: string enum: - person - company source: type: string enum: - USER description: >- ここでは常に`USER`です。このバケットには、主要人物フローでエンドユーザーが入力または確認した当事者のみが含まれます（登記から検出された人物は`registry`の下に表示されます）。 name: type: string first_name: type: string nullable: true last_name: type: string nullable: true company_name: type: string nullable: true registration_number: type: string nullable: true email: type: string format: email nullable: true nationality: type: string nullable: true description: 個人の場合は国籍、企業の当事者の場合は設立国。 phone_number: type: string nullable: true date_of_birth: type: string format: date nullable: true position: type: string nullable: true description: 自由記述の役職・ポジション（個人のみ）。 custom_fields: type: object description: >- この当事者について収集された、ワークフローで定義されたカスタムフィールド。キーはワークフローの主要人物フィールド記述子で定義されます。 is_active: type: boolean is_skipped: type: boolean description: >- エンドユーザーがこの関係者の認証をスキップした場合はtrue（役割でスキップが許可されている場合のみ可能）。 requires_verification: type: boolean description: >- 役割の設定と所有構造のしきい値に基づき、この関係者に子KYC / KYBサブセッションが必要な場合はtrue。 roles: type: array description: >- この当事者が保有するすべての役割です。役割ごとに独自の所有比率と議決権比率があります。当事者自体にはスカラー値の`role`/`ownership_percent`はありません。 items: type: object properties: role: type: string enum: - director - non_executive_director - secretary - chairman - ubo - shareholder - representative - founder - legal_advisor - authorized_signatory - trustee - beneficiary - settlor - protector - company_officer - investor - other ownership_percent: type: number nullable: true voting_percent: type: number nullable: true kyc_session_id: type: string format: uuid nullable: true description: 検証が必要な個人の当事者向けの子KYCセッションID。それ以外の場合は`null`です。 kyc_session_status: type: string enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User nullable: true description: 子KYCセッションのライフサイクルステータス。子KYCセッションが存在しない場合は`null`。 kyc_session_url: type: string format: uri nullable: true kyb_sub_session_id: type: string format: uuid nullable: true description: 検証が必要な法人の当事者向けの子KYBサブセッションID。それ以外の場合は`null`です。 kyb_sub_session_status: type: string enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User nullable: true description: 子KYBサブセッションのライフサイクルステータス。サブセッションが存在しない場合は`null`。 kyb_sub_session_url: type: string format: uri nullable: true description: 子KYBサブセッションの共有可能なURL。サブセッションが存在しない場合は`null`。 verification_workflow_type: type: string nullable: true description: >- 子セッションのワークフローのベースワークフロータイプです（KYCセッションを優先し、ない場合はKYBサブセッションにフォールバックします）。グラフベースのワークフローの場合、または子セッションが存在しない場合は`null`です。 verification_workflow_id: type: string format: uuid nullable: true description: 子セッションが使用するワークフローID。子セッションが存在しない場合は`null`です。 verification_workflow_label: type: string nullable: true description: 子セッションのワークフローの人が読めるラベル。未設定の場合は`null`です。 verification_workflow_features: type: array nullable: true description: >- 子検証セッションの機能ごとの進捗。例：`[{"feature": "ID_VERIFICATION", "status": "Approved"}]`。子セッションに解決可能な機能リストがない場合は`null`。 items: type: object properties: feature: type: string description: '機能の表示名（例: `ID_VERIFICATION`、`LIVENESS`、`AML`）。' status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: 子セッション内の機能レベルのステータスです。 didit_internal_id: type: string nullable: true description: 子セッションの背後にある認証済み個人の不変の内部識別子。特定されていない場合は`null`です。 ubo_kyc_summary: type: object nullable: true description: UBOのKYC進捗の集計。UBOに紐付いたKYCセッションがない場合はnullです。 properties: total: type: integer approved: type: integer flagged: type: integer description: KYCが却下またはレビュー中のUBO。 pending: type: integer warnings: type: array items: type: object document_verifications: type: array nullable: true description: ワークフローノードごとにグループ化された書類検証チェックです。`session_kind = business`の場合にのみ含まれます。 items: type: object description: ワークフローノードごとにグループ化された書類です。session_kind = businessの場合にのみ含まれます。 properties: status: type: string node_id: type: string nullable: true items: type: array items: type: object properties: uuid: type: string format: uuid document_type: type: string enum: - LEGAL_PRESENCE - COMPANY_DETAILS - OWNERSHIP_STRUCTURE - REPRESENTATIVES_AUTHORIZATION - OTHER nullable: true description: ファイルが分類されたKYB書類の大分類です。未分類の間は`null`です。 document_subtype: type: string nullable: true description: >- OCRで検出された具体的なサブタイプ(例: `CERTIFICATE_OF_INCORPORATION`、`SHAREHOLDER_REGISTRY`)。OCRが書類を確実に分類できなかった場合は`UNKNOWN`です。 document_group: type: string enum: - LEGAL_PRESENCE - COMPANY_DETAILS - OWNERSHIP_STRUCTURE - REPRESENTATIVES_AUTHORIZATION - OTHER nullable: true description: >- `document_type`のエイリアスです。`groups`および`required_groups`で使用されるグループ名です。 file_url: type: string format: uri nullable: true description: >- アップロードされたファイルへの有効期間の短い署名付きリンク。まだ対応されていない、アナリストが作成した書類リクエストのプレースホルダー（`is_requested = true`）では`null`です。 original_filename: type: string nullable: true description: ユーザーまたはアナリストがアップロードした際のファイル名。 file_size: type: integer nullable: true description: ファイルサイズ(バイト)。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: 書類ごとの検証ステータス。 created_at: type: string format: date-time cross_check_result: type: object nullable: true description: >- OCRで抽出した書類フィールドと登記上の企業プロファイルとの照合結果。`critical`、`non_critical`、`people`の各セクションを持つオブジェクトで、各セクションはフィールド名（例: `company_name`、`registration_number`、`incorporation_date`、`registered_address`）を`{"document": "...", "registry": "...", "match": true, "score": 0.97}`のような比較レコードに対応付けます。書類にOCRデータがなかった場合、または比較対象となる登記上の企業がなかった場合は`null`です。 document_metadata: type: object nullable: true description: >- アップロードされた法人書類から抽出されたメタデータです。メタデータの抽出に成功した場合、16個のキーは常にすべて含まれます（ファイル形式に該当しない個々の値は`null`になります）。何も抽出できなかった場合は、オブジェクト全体が`null`になります。PDFの場合、`overlay_manipulation`にはオーバーレイテキストのフォレンジック分析結果が含まれます。 properties: file_size: type: integer nullable: true description: 書類のサイズ。 content_type: type: string nullable: true description: 書類のコンテンツタイプ。 creation_date: type: string nullable: true description: 書類の作成日。 modified_date: type: string nullable: true description: 書類の更新日。 creator: type: string nullable: true description: ファイルメタデータに記録された作成ツール/ユーザー（PDFの`Creator`）。 producer: type: string nullable: true description: ファイルを生成したソフトウェア(PDFの`Producer`)。 software: type: string nullable: true description: ファイルのメタデータに記録された編集ソフトウェア。 encryption: type: string nullable: true description: 暗号化されている場合の、ファイルの暗号化方式。 is_signed: type: boolean nullable: true description: 書類にデジタル署名が付与されているかどうか。 is_tampered: type: boolean nullable: true description: デジタル署名の検証に失敗したかどうか(署名後の変更)。 signature_info: type: object nullable: true description: デジタル署名が存在する場合、その詳細。 exif_original_date: type: string nullable: true description: 画像アップロードにおけるEXIFのオリジナル撮影日時。 exif_digitized_date: type: string nullable: true description: 画像アップロードにおけるEXIFのデジタル化日時。 processed_by_known_editor: type: boolean nullable: true description: メタデータから、ファイルが既知の画像/PDFエディターを経由したことが示されているかどうかです。 has_different_creation_mod_date: type: boolean nullable: true description: 作成日と更新日が異なるかどうかです。編集の可能性を示すシグナルですが、決定的ではありません。 overlay_manipulation: type: object nullable: true description: >- オーバーレイテキストによる改ざんが疑われる場合のPDFフォレンジック分析。オーバーレイによる改ざんの証拠が見つからなかった場合、または書類がPDFでなかった場合はnullです。 properties: detected: type: boolean description: オーバーレイテキストによる改ざんの痕跡が検出されたかどうかです。 analyzed: type: boolean description: PDFを解析できたかどうか。 signals: type: array items: type: string description: >- 検出されたフォレンジックシグナル（duplicate_font_subsetやglyph_fragmentationなど）。 manipulated_regions: type: array description: 改ざんが疑われる領域（PDFページ座標）。 items: type: object properties: page: type: integer x: type: number 'y': type: number width: type: number height: type: number page_width: type: number page_height: type: number description: type: string nullable: true description: 書類リクエストに対してアナリストが指定したラベルまたは理由。通常のアップロードでは`null`です。 is_requested: type: boolean description: アナリストが作成した、アップロード待ちの書類リクエストのプレースホルダーの場合はtrue。 ocr_data: type: object nullable: true is_console_upload: type: boolean description: >- エンドユーザーのフローではなくコンソールからアップロードされた書類の場合はtrue。コンソールからのアップロードによって機能レベルの集約ステータスが変わることはありません。 is_confirmed: type: boolean description: >- コンソールからのアップロードは`false`で始まり、管理者が確認すると`true`に切り替わります。エンドユーザーによるアップロードは常に`true`です。 groups: type: object description: >- グループ名（例：legal_presence、ownership_structure）をキーとする、グループごとの進捗カウンター。 additionalProperties: type: object properties: total: type: integer approved: type: integer pending: type: integer declined: type: integer in_review: type: integer other: type: integer missing: type: integer description: リクエスト済みで、まだファイルがアップロードされていないプレースホルダー。 required_groups: type: array items: type: string warnings: type: array items: type: object environment: type: string enum: - live - sandbox description: >- セッションが本番アプリケーション(`live`)とサンドボックスアプリケーション(`sandbox`)のどちらで作成されたか。サンドボックスのセッションは無料で、完全にシミュレートされ、クレジットが課金されることはありません。 sandbox_scenario: type: string nullable: true description: >- セッション作成時に指定されたサンドボックスシナリオです。本番環境のセッション、およびシナリオを指定せずに作成されたサンドボックスセッションでは`null`になります。 resubmissions: type: array description: >- `include=resubmissions`を指定した場合にのみ、ユーザーセッションと企業セッションで返されます。再提出リクエストごとに1件のエントリーがあり、古い順に並びます。各エントリーには、リクエスト前に再提出対象のステップが返した結果が含まれるため、以前の提出内容も引き続き参照できます。セッションを削除すると、すべての提出内容が削除されます。 items: type: object properties: number: type: integer description: セッションの1回目の再提出では1、2回目では2、以降も同様です。 created_at: type: string format: date-time description: 再提出がリクエストされた日時。 previous_status: type: string description: リクエスト直前のセッションのステータス。 nodes: type: array description: ユーザーに差し戻されたワークフローのステップ。 items: type: object properties: node_id: type: string feature: type: string reasons: type: object nullable: true additionalProperties: type: string description: 各ステップについて示された理由。`node_id`をキーとします。 requested_by: type: object nullable: true description: 再提出を要求した者です。 properties: name: type: string email: type: string type: type: string results: type: object additionalProperties: true description: >- リクエスト前に再提出されたステップが返していた結果です。このレスポンスの現在の結果と同じキー、同じ形式で返されます（`id_verifications`、`nfc_verifications`、`liveness_checks`、`face_matches`、`poa_verifications`、`phone_verifications`、`email_verifications`、`aml_screenings`、`ip_analyses`、`database_validations`、`questionnaire_responses`、`document_ai_documents`、`geolocation_checks`。企業セッションでは`document_verifications`も含まれます）。差し戻されたステップのキーのみが含まれます。 biometric_consent: type: object nullable: true description: >- 顔撮影の前にセッションで明示的な生体認証の同意が必要だったかどうか、その理由、および回答の証跡。ユーザー認証(KYC)セッションのみが対象で、同じオブジェクトがセッションWebhookの`decision`にも含まれます。顔撮影のないワークフローなど、セッションが一度も評価されなかった場合は`null`です。値が記録されていないフィールドは`null`です。4.10.0未満のネイティブSDK、またはバージョンを報告しないSDKは同意ステップを表示できません。その場合、顔撮影は従来どおり実行され、同意が必要だったセッションは`status: "pending"`と`reason: "BIOMETRIC_CONSENT_UNSUPPORTED_SDK"`を報告します。[生体認証の同意](/ja/getting-started/biometric-consent)を参照してください。 properties: required: type: boolean description: >- Whether the session must collect explicit biometric consent. Never goes back to `false`. trigger: type: string nullable: true enum: - declared_state - ip_state - ip_unknown - document_issuer - forced - customer_collected description: >- 同意が必要な理由、または同意がどのように満たされたか。`declared_state`：対象となる州を申告しました（`user_state`、または`expected_details`内の米国の住所）。`ip_state`：本人のIPが対象州（イリノイ州、テキサス州、コロラド州）にあります。`ip_unknown`：証拠から本人が米国にいることはわかるものの、州を特定できません（IPが米国内だが州が不明な場合、またはIPの位置を特定できないが、あなたが指定した情報や書類から本人が米国にいると判断される場合）。`document_issuer`：本人確認書類が対象州によって発行されています。`forced`：アプリケーションのモードがAlwaysです。`customer_collected`：セッション作成時に`biometric_consent`を送信しました。必要でない間は`null`です。 status: type: string enum: - not_required - pending - given - declined description: >- `not_required`、`pending`（必須だが未取得: 本人がまだ回答していないか、`reason`に収集されなかった理由が示されます）、`given`、`declined`（拒否が記録され、セッションは`Declined`で終了しました。現在、拒否を選択できるDiditの画面はありません）。 given_at: type: string format: date-time nullable: true description: 同意が得られた日時。`customer_collected`の場合は、送信した`given_at`です。 declined_at: type: string format: date-time nullable: true description: 却下が記録された日時。 text_version: type: string nullable: true description: 本人が回答した同意文、または自社が送信した同意文のバージョンID。 text_hash: type: string nullable: true description: 表示された同意文そのもののSHA-256（16進数）。表示時の言語で計算します。 locale: type: string nullable: true description: 同意文が表示された言語。 policy_url: type: string format: uri nullable: true description: 同意ステップがリンクしていた生体データポリシー。 step: type: string nullable: true description: '本人が回答した時点でセッションが位置していたワークフローステップ（例: `LIVENESS`）。' node_id: type: string nullable: true description: 本人が回答した時点でセッションが位置していたワークフローグラフのノード。 ip_address: type: string nullable: true description: 回答の送信元IP。 ip_country_code: type: string nullable: true description: 回答のIPが属する国を示すISO 3166-1 alpha-2コード。 ip_state: type: string nullable: true description: '回答のIPアドレスのISO 3166-2地域区分。例: `US-IL`。' ip_city: type: string nullable: true description: 回答のIPの都市。 user_agent: type: string nullable: true description: 回答のリクエストのユーザーエージェント。 detected_ip_address: type: string nullable: true description: 要件が最後に評価された際のこの人物のIPです。人物が別のデバイスで回答した場合は`ip_address`と異なることがあります。 detected_country_code: type: string nullable: true description: 検出されたIPの国を示すISO 3166-1 alpha-2コード。 detected_state: type: string nullable: true description: 検出されたIPアドレスのISO 3166-2地域区分。 detected_city: type: string nullable: true description: 検出されたIPの都市。 declared_state: type: string nullable: true description: >- 申告したISO 3166-2地域区分です。`user_state`、または`expected_details`内の米国の住所の州を指します。 document_state: type: string nullable: true description: 身分証明書を発行したISO 3166-2地域区分。IDキャプチャ時に読み取られます。 jurisdictions: type: array items: type: string description: >- その人物が生体情報に関する法律の対象となる米国の州(USPSコード、例: `IL`)。証拠からその人物が米国にいることは示されるものの州が不明な場合は`US`です。該当するものがない場合は空です。 retention_months: type: integer nullable: true description: '`jurisdictions`のうち最も短い生体データの保持期限（月数）。該当するものがない場合は`null`です。' reason: type: string nullable: true enum: - BIOMETRIC_CONSENT_UNSUPPORTED_SDK - BIOMETRIC_CONSENT_DECLINED description: >- `BIOMETRIC_CONSENT_UNSUPPORTED_SDK`：同意が必須であったにもかかわらず、4.10.0未満のネイティブSDK、またはバージョンを報告しなかったネイティブSDKが、同意ステップを経ずに顔を撮影した場合です。`status`は`pending`のままとなり、本人が後でホスト型フローで同意した場合は`given`になります。`BIOMETRIC_CONSENT_DECLINED`：拒否が記録された場合です（SDKによる理由を置き換えます）。それ以外は`null`で、セッションで同意が不要だった場合は常に`null`です。 decline_reason: type: string nullable: true enum: - BIOMETRIC_CONSENT_DECLINED description: >- 記録された拒否によってセッションが終了した場合は`BIOMETRIC_CONSENT_DECLINED`、それ以外は`null`です。 face_data_deleted_at: type: string format: date-time nullable: true description: 却下によってセッションの顔画像、動画、顔テンプレートが削除された日時。却下が記録されていない場合は`null`。 investigator: $ref: '#/components/schemas/InvestigatorBlock' biometric_retention: $ref: '#/components/schemas/BiometricRetention' fraud_check: type: object nullable: true additionalProperties: true description: Fraud Check API呼び出しの結果です。それ以外のすべてのセッションでは`null`です。 full_session_video: type: string format: uri nullable: true description: セッション全体の録画の有効期限付きURLです。組織がセッション全体の動画を録画している場合にのみ返されます。 full_session_video_recorded_at: type: string format: date-time nullable: true description: セッション全体の録画が行われた日時。組織がセッション全体の動画を録画している場合にのみ返されます。 AddressValidationResult: type: object description: >- 1件のAddress Validationの結果です。住所が存在するかどうかと、その正規化された形式を示します。住所の確認のみを行い、住所を個人と紐付けることはありません。 required: - status - verification_level - address - formatted_address - latitude - longitude properties: status: type: string enum: - verified - partially_verified - not_verified - unavailable description: >- `verified`：住所が建物単位（または部屋番号や私書箱単位）まで確認されました。`partially_verified`：通りまで、またはその場所について郵便参照データが保持する最も詳細なレベルまでしか確認されませんでした。`not_verified`：地域または市区町村のみが一致したか、何も一致しませんでした。`unavailable`：検証を実行できませんでした（例：参照サービスが応答しなかった場合）。この場合は課金されず、認証に影響することはありません。 verification_level: type: string nullable: true enum: - administrative_area - locality - thoroughfare - premise - delivery_point - null description: 住所が一致した最も詳細なレベルです。何も一致しなかった場合、または`status`が`unavailable`の場合は`null`です。 address: type: object nullable: true description: 正規化済みの住所。`status`が`unavailable`の場合は`null`です。 properties: address_line_1: type: string nullable: true description: 配送先住所の1行目です。その国の表記どおりに記載します。 example: 1600 Amphitheatre Pkwy address_line_2: type: string nullable: true description: 住所に2行目がある場合の配送先情報の2行目（部屋番号、建物名、地区名など）。 city: type: string nullable: true example: Mountain View region: type: string nullable: true description: 州、県、または地域。 example: CA postal_code: type: string nullable: true example: 94043-1351 country: type: string nullable: true description: ISO 3166-1 alpha-2国コード。 example: US formatted_address: type: string nullable: true description: 1行にまとめた正規化済みの住所。 example: 1600 Amphitheatre Pkwy, Mountain View CA 94043-1351 latitude: type: number nullable: true example: 37.422022 longitude: type: number nullable: true example: -122.08429 PhoneIntelligence: type: object description: >- 正規化された電話番号インテリジェンスブロック。この照会に対してインテリジェンスアドオンが実行された場合にのみ存在します。存在する場合は、同一の値を持つ`enrichment`エイリアスでも公開されます。 properties: score: type: number nullable: true description: 0-100に正規化されたリスクスコア。値が高いほどリスクが高くなります。 phone_type_risk: type: string nullable: true description: スコアから算出される`Low`、`Medium`、`High`のいずれかです。 phone_trust_index: type: number nullable: true description: スコアの逆数です。値が高いほど良いことを示すダッシュボード向けです。 network_stability_index: type: number nullable: true description: 回線のネットワークの安定性。 is_disposable: type: boolean nullable: true description: 番号が使い捨てまたは仮想番号と見られる場合は`true`です。 is_ported: type: boolean nullable: true description: 番号の通信事業者が変更されている場合は`true`です。 is_recently_ported: type: boolean nullable: true description: 番号ポータビリティが最近行われた場合は`true`です。 carrier_type: type: string nullable: true description: 'ルックアップで報告された回線の分類（例: `mobile`）。' reason_codes: type: array items: type: object properties: code: type: string description: >- シグナルの不変のDidit識別子。例: `IR-5AC67A32`。不透明な値のため、グループ化やフィルターには使用できますが、解析はしないでください。 value: nullable: true description: >- リスクフラグ（例：`voip`、`leaked`、`disposable`、`spam_trap`）の場合、その値です：真偽値、レベル、または日付。スコア付きの理由コードではnullです。 direction: type: string enum: - risk - trust description: シグナルがリスクを高めたか、信頼を加えたか。 message: type: string description: シグナルを人が読める形で説明したもの（英語）。 impact_level: type: string nullable: true description: シグナルがスコアに与えた影響の強さ。例：`low`、`medium`、`high`。 description: >- スコアの根拠となるシグナル。それぞれに安定したDiditコード、方向、メッセージ、影響度があります。新しいコードが今後追加される可能性があるため、未知のコードを拒否しないでください。 PhoneSocialFootprint: type: object nullable: true description: >- 電話番号のソーシャルフットプリント: その電話番号が登録されているオンラインプラットフォームです。`enable_social`が設定され、チェックが完了した場合にのみ含まれます。データが返されなかった項目の件数は、いずれもnullになる場合があります。`profiles_registered: 0`は、プラットフォームがチェックされ、そのいずれにも電話番号が見つからなかったことを意味します。これは有効かつ課金対象の結果であり、合成IDによく見られる兆候です。 properties: profiles_registered: type: integer nullable: true description: 電話番号の登録が確認されたプラットフォーム。 example: 5 profiles_checked: type: integer nullable: true description: 登録状況を評価したプラットフォーム。 example: 14 names_found: type: integer nullable: true description: 関連付けられた名前を返したプラットフォーム。 example: 0 photos_found: type: integer nullable: true description: プロフィール写真を返したプラットフォーム。 example: 0 communication_breadth: type: integer nullable: true description: 存在が検出されたコミュニケーションプラットフォーム。 example: 2 digital_footprint_diversity: type: integer nullable: true description: 存在が検出された個別のプラットフォームカテゴリ。 example: 5 digital_sophistication_index: type: integer nullable: true description: デジタル成熟度の総合指標（0-10）。 example: 5 engagement_depth_index: type: integer nullable: true description: プロフィールの充実度を示す指標(0-10)。 example: 3 subscription_affordability_index: type: integer nullable: true description: 無料プラットフォームと有料プラットフォームの構成比（0-10）。 example: 2 free_platforms: type: integer nullable: true description: 無料プラットフォームでの登録。 example: 4 full_paid_platforms: type: integer nullable: true description: 完全有料プラットフォームでの登録。 example: 0 partial_paid_platforms: type: integer nullable: true description: フリーミアムプラットフォームでの登録。 example: 1 whatsapp_profile_completeness: type: string nullable: true enum: - Basic - Partial - Complete - Not Present - null description: WhatsAppプロフィールの充実度。電話番号のみ対象で、メールアドレスの場合はnullです。 example: Partial registered_platforms: type: array description: 登録が確認されたプラットフォーム。 items: $ref: '#/components/schemas/SocialFootprintPlatform' not_registered_platforms: type: array description: 確認の結果、否定的な結果となったプラットフォーム。 items: $ref: '#/components/schemas/SocialFootprintPlatform' categories: type: object description: プラットフォームカテゴリごとの登録数と割合。 additionalProperties: $ref: '#/components/schemas/SocialFootprintCategorySummary' profiles: type: object description: プラットフォームが公開している場合の、プラットフォームごとのプロフィール詳細です。プラットフォームをキーとします。 additionalProperties: $ref: '#/components/schemas/SocialFootprintProfile' EmailIntelligence: type: object description: >- 正規化されたメールインテリジェンスブロック。このメールアドレスに対してインテリジェンスアドオンが実行された場合にのみ存在します。存在する場合は、同一の値を持つ`enrichment`エイリアスとしても公開されます。 properties: score: type: number nullable: true description: 0-100に正規化されたリスクスコア。値が高いほどリスクが高くなります。 deliverable: type: string nullable: true description: 配信可能性の区分(例:`high`)。 breach_risk_level: type: string nullable: true description: '`Low`、`Medium`、`High`のいずれかです。' breach_risk_index: type: number nullable: true description: 情報漏えいリスクの数値指標です。 is_recent_breach: type: boolean nullable: true description: このアドレスが最近の情報漏えいに含まれている場合は`true`です。 is_frequent_breached: type: boolean nullable: true description: このアドレスが多数の情報漏えいに含まれている場合は`true`です。 is_disposable: type: boolean nullable: true description: ドメインが使い捨てメールプロバイダーである場合は`true`です。 is_free_domain: type: boolean nullable: true description: ドメインがフリーメールプロバイダーである場合は`true`です。 is_breached: type: boolean nullable: true description: このアドレスが既知の情報漏えいに含まれている場合は`true`です。 no_of_breaches: type: number nullable: true description: このメールアドレスを含む既知のデータ侵害の数。 reason_codes: type: array items: type: object properties: code: type: string description: >- シグナルの不変のDidit識別子。例: `IR-5AC67A32`。不透明な値のため、グループ化やフィルターには使用できますが、解析はしないでください。 value: nullable: true description: >- リスクフラグ（例：`voip`、`leaked`、`disposable`、`spam_trap`）の場合、その値です：真偽値、レベル、または日付。スコア付きの理由コードではnullです。 direction: type: string enum: - risk - trust description: シグナルがリスクを高めたか、信頼を加えたか。 message: type: string description: シグナルを人が読める形で説明したもの（英語）。 impact_level: type: string nullable: true description: シグナルがスコアに与えた影響の強さ。例：`low`、`medium`、`high`。 description: >- スコアの根拠となるシグナル。それぞれに安定したDiditコード、方向、メッセージ、影響度があります。新しいコードが今後追加される可能性があるため、未知のコードを拒否しないでください。 EmailSocialFootprint: type: object nullable: true description: >- メールアドレスのソーシャルフットプリント: そのメールアドレスが登録されているオンラインプラットフォームです。`enable_social`が設定され、チェックが完了した場合にのみ含まれます。データが返されなかった項目の件数は、いずれもnullになる場合があります。`profiles_registered: 0`は、プラットフォームがチェックされ、そのいずれにもメールアドレスが見つからなかったことを意味します。これは有効かつ課金対象の結果であり、合成IDによく見られる兆候です。 properties: profiles_registered: type: integer nullable: true description: メールアドレスの登録が確認されたプラットフォーム。 example: 5 profiles_checked: type: integer nullable: true description: 登録状況を評価したプラットフォーム。 example: 14 names_found: type: integer nullable: true description: 関連付けられた名前を返したプラットフォーム。 example: 0 photos_found: type: integer nullable: true description: プロフィール写真を返したプラットフォーム。 example: 0 communication_breadth: type: integer nullable: true description: 存在が検出されたコミュニケーションプラットフォーム。 example: 2 digital_footprint_diversity: type: integer nullable: true description: 存在が検出された個別のプラットフォームカテゴリ。 example: 5 digital_sophistication_index: type: integer nullable: true description: デジタル成熟度の総合指標（0-10）。 example: 5 engagement_depth_index: type: integer nullable: true description: プロフィールの充実度を示す指標(0-10)。 example: 3 subscription_affordability_index: type: integer nullable: true description: 無料プラットフォームと有料プラットフォームの構成比（0-10）。 example: 2 free_platforms: type: integer nullable: true description: 無料プラットフォームでの登録。 example: 4 full_paid_platforms: type: integer nullable: true description: 完全有料プラットフォームでの登録。 example: 0 partial_paid_platforms: type: integer nullable: true description: フリーミアムプラットフォームでの登録。 example: 1 whatsapp_profile_completeness: type: string nullable: true enum: - Basic - Partial - Complete - Not Present - null description: WhatsAppプロフィールの充実度。電話番号のみ対象で、メールアドレスの場合はnullです。 example: Partial registered_platforms: type: array description: 登録が確認されたプラットフォーム。 items: $ref: '#/components/schemas/SocialFootprintPlatform' not_registered_platforms: type: array description: 確認の結果、否定的な結果となったプラットフォーム。 items: $ref: '#/components/schemas/SocialFootprintPlatform' categories: type: object description: プラットフォームカテゴリごとの登録数と割合。 additionalProperties: $ref: '#/components/schemas/SocialFootprintCategorySummary' profiles: type: object description: プラットフォームが公開している場合の、プラットフォームごとのプロフィール詳細です。プラットフォームをキーとします。 additionalProperties: $ref: '#/components/schemas/SocialFootprintProfile' DocumentAIDetectedCode: type: object required: - type - page_number - position - x - 'y' - width - height - page_width - page_height - raw_payload - parsed_payload properties: type: type: string description: 検出されたシンボロジー。例：`QR_CODE`、`CODE_128`、`EAN_13`、`DATA_MATRIX`、`PDF_417`。 page_number: type: integer minimum: 1 description: ページ番号（1始まり）。 position: type: array nullable: true description: レンダリングされたページのピクセル座標で表した、検出されたポリゴン。信頼できる位置が得られない場合は`null`です。 items: type: array minItems: 2 maxItems: 2 items: type: integer x: type: integer nullable: true description: バウンディングボックスの左端。レンダリングされたページのピクセル単位で表します。 'y': type: integer nullable: true description: レンダリングされたページのピクセル単位で表した、バウンディングボックスの上端。 width: type: integer nullable: true description: レンダリングされたページのピクセル単位でのバウンディングボックスの幅。 height: type: integer nullable: true description: レンダリングされたページのピクセル単位でのバウンディングボックスの高さ。 page_width: type: integer description: レンダリングされたページの幅(ピクセル)。 page_height: type: integer description: レンダリングされたページの高さ(ピクセル)。 raw_payload: type: string description: 利用可能な場合はデコーダーの生のペイロードをBase64文字列で返し、それ以外の場合は空文字列を返します。 parsed_payload: nullable: true description: デコードされた文字列または構造化された値。コードの位置は特定できたもののデコードできなかった場合は`null`です。 BankVerificationResult: type: object description: >- ユーザー認証および法人確認における、1つの銀行口座認証ステップの結果。`method`は口座がどのように認証されたかを示し、`none`は試行が評価される前に本人が銀行口座なしで続行したことを示します。`continued_without_bank`は、評価済みの試行の後も含めて、本人が銀行口座なしで続行したことを示します。[銀行口座認証の方法](/ja/core-technology/bank-verification/verification-methods)および[本人が銀行口座を認証できない場合](/ja/core-technology/bank-verification/fallbacks)を参照してください。 properties: schema_version: type: integer description: この結果の形式のバージョン。現在は`1`です。 bank_verification_id: type: string format: uuid description: この結果のID。 node_id: type: string description: この結果が属するワークフローのノード。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Expired description: アクションとステータスルールを適用した後のステップの判定。 original_status: type: string nullable: true description: 手動レビューなどの後続の変更が行われる前に、ステップが最初に下した判定です。 method: type: string nullable: true enum: - open_banking - account_lookup - microdeposits - statement - none description: >- 口座の確認方法：`open_banking`（銀行サインイン：本人が自分の銀行にサインイン）、`account_lookup`（口座確認：本人が口座情報を入力し、銀行が名義を確認）、`microdeposits`、または`statement`（明細書のアップロード）。評価された試行がないまま本人が銀行を使わずに続行した場合は`none`となり、口座は確認されていません。評価された試行の後は、その試行の方法のままになります。口座が評価されるまで、およびワークフローが返すデータを絞り込んでいる場合は`null`です。ワークフローのルールは同じ値を`bank.method`として読み取ります。 provider: type: string nullable: true description: 接続を実行したルートのキーです。アカウントがどのように検証されたかを判断するには、このキーではなく`method`を参照してください。 credential_source: type: string nullable: true enum: - native - byok description: >- `native`: Didit独自のルートで、Diditの残高に請求されます。`byok`: お客様自身の認証情報で接続したマーケットプレイスのプロバイダー。 route: type: object nullable: true description: 同意の前に選択されたルートです。その後変更されることはありません。 properties: provider_key: type: string nullable: true description: ルートのキーです。 credential_source: type: string enum: - native - byok is_fallback: type: boolean description: 接続できなかったマーケットプレイスプロバイダーの代わりに、Didit自身のルートが使われたかどうかです。 provider_connection_id: type: string nullable: true description: '`byok`の場合に使用されたマーケットプレイス接続です。' requested_scopes: type: array items: type: string description: 接続がリクエストしたデータです。例えば`ownership`や`balances`などです。 connection: type: object nullable: true description: 最新の試行の接続です。最初の試行の前は`null`です。 properties: status: type: string enum: - pending - connected - cancelled - timeout - failed - unsupported - revoked - expired institution_id: type: string nullable: true description: 銀行のID。口座チェックでは銀行が選択されないため`null`です。 institution_name: type: string nullable: true description: 銀行名。口座チェックでは`null`です。 institution_country: type: string nullable: true description: 口座の国（ISO 3166-1 alpha-3）。 oauth: type: boolean nullable: true description: 銀行へのサインインがOAuthとアプリ間連携のどちらで行われたか。口座確認の場合は`null`です。 connected_at: type: string format: date-time nullable: true description: 接続に成功した日時。 consent_expires_at: type: string format: date-time nullable: true description: 銀行サインインにおいて、銀行の同意が終了する日時。 last_refreshed_at: type: string format: date-time nullable: true description: 財務データが最後に再取得された日時。 attempts: type: integer description: このステップでその人が使用した試行回数（すべての方法の合計）。 reason_code: type: string nullable: true description: >- 接続が単に`connected`ではない理由。例：`USER_CANCELLED`、`INSTITUTION_DOWN`、`ACCOUNT_NOT_FOUND`、`REFERENCE_IDENTITY_MISSING`、`VERIFICATION_COMPLETED`。 account: type: object nullable: true description: 評価されたアカウントです。アカウントが評価されるまでは`null`です。 properties: account_id_masked: type: string nullable: true description: マスクされた口座番号。 iban_masked: type: string nullable: true description: マスクされたIBAN。 sort_code: type: string nullable: true description: ソートコード（英国）。 routing_number_masked: type: string nullable: true description: マスクされたルーティング番号です。 type: type: string nullable: true enum: - checking - current - savings - business - other subtype: type: string nullable: true description: 銀行独自の口座サブタイプ。 currency: type: string nullable: true description: 口座のISO 4217通貨。 holder_type: type: string nullable: true enum: - person - business - unknown holders_count: type: integer nullable: true is_joint: type: boolean nullable: true is_business: type: boolean nullable: true ownership: type: object nullable: true description: 口座名義人と認証済みの本人情報との比較結果。口座が評価されるまでは`null`です。 properties: result: type: string enum: - match - partial_match - no_match - unknown - not_verifiable description: >- `partial_match`は近い一致です。`not_verifiable`: 銀行から応答はあったものの、照合対象の名義人が含まれていませんでした。`unknown`: 証拠を読み取れなかったか、照合する本人情報がありませんでした。 reference_identity_source: type: string nullable: true description: >- 保有者の身元を照合した対象のステップ。`kyc`、`database_validation`、`expected_details`、`questionnaire`、`document_ai`、`kyb`のいずれかです。 name_score: type: integer minimum: 0 maximum: 100 nullable: true description: Diditによる名義人氏名のスコアです。 provider_name_score: type: integer minimum: 0 maximum: 100 nullable: true description: 銀行が返した場合の、銀行独自の名義人名スコア。 address_score: type: integer minimum: 0 maximum: 100 nullable: true description: 住所照合が実行された場合の、名義人の住所スコアです。 email_score: type: integer minimum: 0 maximum: 100 nullable: true description: メールアドレス照合が実行された場合の、名義人のメールアドレススコアです。 phone_score: type: integer minimum: 0 maximum: 100 nullable: true description: 電話番号照合が実行された場合の、名義人の電話番号スコアです。 dob_score: type: integer minimum: 0 maximum: 100 nullable: true description: 銀行が生年月日を共有した場合の、名義人の生年月日スコアです。 close_match: type: boolean nullable: true description: 名前が近似一致の範囲に入ったかどうか。 holder_confirmation: type: string nullable: true enum: - pending - confirmed - rejected description: 近似一致した名前の確認を求められた際のこの人物の回答です。一度も求められていない場合は`null`です。 method: type: string nullable: true enum: - exact - token_set - nickname - transliteration - fuzzy - provider_only - microdeposits description: >- スコアを算出した氏名照合の方式。これは認証方法ではありません。認証方法についてはトップレベルの`method`を参照してください。 matched_holder_index: type: integer nullable: true holders: type: array items: type: object description: 銀行が記載した各名義人とそのスコア。 owner_identity_available: type: boolean nullable: true evidence_freshness: type: string nullable: true enum: - live - cached - refreshed evaluated_at: type: string format: date-time nullable: true description: 判定結果が算出された日時。 financial_data: type: object description: ステップが読み取った金融データです。これを読み取るのは銀行サインインのみです。 properties: balances: type: object nullable: true description: '`balances`スコープを指定した場合。' transactions: type: object nullable: true description: '`transactions`スコープを指定した場合。' income: type: object nullable: true description: '`income`スコープを指定した場合。' categorization: type: object nullable: true description: 読み取った取引に対するDiditの分類です。取引がない場合は`null`です。 not_collected: type: array items: type: string enum: - balances - income - transactions description: >- ステップがリクエストしたデータのうち、口座を検証した方法では収集されないデータです。残高、取引、収入は銀行サインインでのみ取得されるため、口座確認で検証された口座ではここに列挙されます。失敗を意味するものではありません。それ以外の場合は空です。 billing: type: object nullable: true properties: route: type: string enum: - native - byok billed: type: boolean marketplace_fee: type: string nullable: true description: '`byok`の場合に請求されるマーケットプレイスのプラットフォーム手数料です。' usage_type: type: string nullable: true description: >- 料金が計上された利用明細行。銀行サインインまたは口座確認の場合は`bank_verification`、それ以前に課金された銀行認証の試行がない明細書アップロードの場合は`bank_statement_upload`、独自のプロバイダーを使用する場合のマーケットプレイス手数料は`bank_byok_fee`です。何も請求されなかった場合は`null`。 reference_identity: type: object nullable: true description: 名義人の照合対象となったアイデンティティと、そのソースです。 signals: type: object nullable: true description: ステップが取引履歴を読み取った場合に、取引履歴から読み取ったアカウントのシグナル。 connection_abandoned: type: boolean nullable: true description: 本人が銀行で離脱した後、一致なしでステップが終了したかどうか。 not_covered: type: boolean nullable: true description: >- このステップで本人の銀行または国に接続できなかったかどうか。本人の国または銀行を検証できる方法がなく、銀行なしで続行した場合も`true`になります。 continued_without_bank: type: boolean description: >- 本人が**Continue without your bank**でステップを終えたかどうか。その場合、`continuation`に理由が示されます。続行する前に評価された試行がない場合、`method`は`none`です。名義人の不一致など評価済みの試行の後は、`method`はその試行の方法のままとなり、その判定と理由コードも維持されます。ワークフローが返すデータを絞り込んでいる場合でも返されます。 continuation: type: object nullable: true description: >- 本人が銀行を使わずに続行した方法。銀行を使わずに続行しなかった場合は`null`です。ワークフローが返すデータを絞り込んでいる場合も`reason`は返され、それ以外のキーはすべて`null`になります。 properties: reason: type: string enum: - no_route - institution_unsupported - attempts_exhausted - person_choice description: >- その人物が続行した時点でDiditが判断した理由。`no_route`（その国に対応する銀行サインインや口座確認がない）、`institution_unsupported`（選択した銀行がこのステップで使用できない）、`attempts_exhausted`（すべての試行がすでに使い切られ、進行中のものもない）、または`person_choice`（検証手段があったにもかかわらず続行を選んだ。銀行に現時点で接続できなかった場合も含む）のいずれかです。評価済みの試行がすでにステップを決定している場合を除き、`no_route`と`institution_unsupported`は`bank_unsupported_action`に、`attempts_exhausted`は`bank_attempts_exhausted_action`に、`person_choice`は`bank_skipped_action`に従います。 country: type: string nullable: true description: 本人が認証を行っていた国(ISO 3166-1 alpha-3)。国を選択する前に先へ進んだ場合は`null`です。 offered: type: array items: type: string enum: - statement - microdeposits nullable: true description: >- 本人が続行した際に、その国で本人に提示された他の検証方法。提示された順に並びます：`statement`（明細書のアップロード）、次に`microdeposits`。何も提示されなかった場合は空です。 institution_id: type: string nullable: true description: >- `institution_unsupported`の場合、本人が利用できなかった銀行のIDです：本人が選択した銀行、または最後の試行が終了した銀行です。DiditはこのIDを独自の銀行リストから取得し、本人のデバイスからは取得しないため、そのリストにない銀行は`null`になります。その他の理由の場合はすべて`null`です。 institution_name: type: string nullable: true description: >- `institution_unsupported`の場合、その銀行の名前です（`institution_id`と同じリストから取得）。そのリストにその銀行がない場合、およびその他すべての理由の場合は`null`です。 continued_at: type: string format: date-time nullable: true description: 本人が続行した日時。 evidence_purged_at: type: string format: date-time nullable: true description: '`bank_evidence_retention_days`に基づいて銀行のエビデンスが削除された日時。それ以外の場合は`null`。' warnings: type: array items: type: string description: '`holder_declared`などの情報コード。警告だけでステータスが変わることはありません。' reason_codes: type: array items: type: string description: >- 判定がその結果になった理由。例：`OWNER_NAME_PARTIAL`。複数が該当する場合があります。`NOT_COVERED`：その人物の国または銀行を検証できる方法がなかったため、銀行なしで続行しました。`SKIPPED`：検証手段があったにもかかわらず、その人物が銀行なしで続行することを選びました。評価済みの試行がすでにステップを決定している場合は、どちらも追加されません。 created_at: type: string format: date-time updated_at: type: string format: date-time SignatureResult: type: object description: >- 1つの電子署名ステップにおける署名者1名の結果です。[電子署名レポート](/ja/core-technology/electronic-signature/report-electronic-signature)を参照してください。 properties: id: type: string format: uuid description: この署名者の証跡をダウンロードする場合や署名を検証する場合は、これを`signature_id`として渡します。 node_id: type: string description: これを生成したワークフローのステップ。 status: type: string enum: - intro - review - code - signing - signed - declined description: ステップ内での署名者の状況です。書類が署名済みであることを意味するのは`signed`のみです。 verdict: type: string enum: - Not Finished - Approved - In Review - Declined description: ステップの結果。警告はそのルールを通じて結果を設定し、カスタムステータスルールはその後に適用されます。 level: type: string enum: - simple - aes - qes description: '`simple`（デフォルト）または`aes`です。`qes`（適格電子署名、QES）はアドオンで、まだ提供されていません。' format: type: string enum: - pdf - pades description: Simple署名の場合は`pdf`、Advanced（AES）の場合は`pades`です。 profile: type: string nullable: true description: 高度電子署名（AES）が署名されると`PAdES-B-LT`、それ以外はnullです。 signer: type: object properties: name: type: string nullable: true description: >- 署名者の氏名。検証済みの氏名（承認済みの本人確認またはセッションから取得）ですが、検証済みのセッション名がないSimpleレベルの場合は例外で、署名者が入力した氏名となり、検証されていません。 capacity: type: string enum: - self - company company: type: string nullable: true role: type: string nullable: true description: 申告された主要人物の役職です。 roles: type: array items: type: string description: 企業について申告された主要人物の構造化された役割です。 identity_session_id: type: string format: uuid description: 署名者を検証したKYCセッション。 identity_used: type: object description: 署名の根拠となる検証済みの本人情報。検証済みの本人情報がないSimple署名の場合は空です。 properties: session_id: type: string format: uuid kyc_id: type: string format: uuid nullable: true verified: type: boolean expected_name: type: string nullable: true description: 署名者が一致する必要があった名前です。 certificate: type: object nullable: true description: 書類の署名に使用された証明書。署名されるまでは`null`で、Simple署名の場合は常に`null`です。 properties: issuer: type: string issued_to: type: string serial: type: string description: シリアル番号（16進数）。 valid_from: type: string format: date-time valid_until: type: string format: date-time confirmation: type: object properties: channel: type: string nullable: true enum: - email - sms description: Simple署名の場合は、コードがないため`null`です。 destination: type: string nullable: true description: コードの送信先となった、マスク済みの連絡先です。 confirmed_at: type: string format: date-time nullable: true attempts: type: integer description: 入力されたコード（正しいコードを含む）。 timestamp: type: object nullable: true description: >- 署名に含まれるRFC 3161タイムスタンプで、Diditが発行します。署名されるまでは`null`で、Simple署名では常に`null`です。 properties: time: type: string format: date-time qualified: type: boolean description: AESの場合は常に`false`です。 valid: type: boolean documents: type: array items: type: object properties: id: type: string format: uuid description: この署名者のコピーにある書類です。署名済みファイルのダウンロードに使用します。 uuid: type: string format: uuid description: '`id`と同じ。' title: type: string file_name: type: string pages: type: integer description: 署名された書類のページ。Wordの場合は、変換後のPDFのページです。 size_bytes: type: integer sha256_original: type: string description: 署名者に表示された時点の書類のSHA-256。 sha256_signed: type: string nullable: true description: 署名後の、署名済みPDFのSHA-256。 status: type: string enum: - signed - declined - not_signed - not_reached description: '`not_signed`: 開かれましたが署名されていません。`not_reached`: 一度も開かれていません。' opened_at: type: string format: date-time nullable: true read_at: type: string format: date-time nullable: true description: ステップで必須とされている場合に、署名者がフィールドのない書類の最後まで到達した日時。 read_to_end: type: boolean consented_at: type: string format: date-time nullable: true description: 署名者がフィールドのない書類に同意した日時、またはフィールドのある書類のフィールドへの入力を完了した日時。 consent: type: boolean signed_file: type: string nullable: true description: >- 署名後の署名済みPDFのパス。[署名済み書類をダウンロード](/ja/sessions-api/electronic-signature/download-signed-document)を参照してください。 mode: type: string enum: - fields - read_and_agree description: フィールドがある書類の場合は`fields`、フィールドがない書類の場合は`read_and_agree`。 source_format: type: string enum: - pdf - docx description: '`pdf`、またはDiditがPDFに変換したWord文書の場合は`docx`です。' conversion: type: object nullable: true description: PDFの場合は`null`です。Word文書の場合は、元のファイルと変換後のファイルです。 properties: from: type: string enum: - docx file_name: type: string description: 元のWordファイル名です。 sha256: type: string description: 元のWordファイルのSHA-256。 size_bytes: type: integer description: 元のWordファイルのサイズ。 converter: type: string description: PDFを生成したコンバーターのバージョン。 fields: type: array description: 書類のフィールドとその値。フィールドのない書類では空です。 items: $ref: '#/components/schemas/SignatureFieldResult' adopted_signature: type: object nullable: true description: 署名者が署名フィールドとイニシャルフィールド用に採用した署名とイニシャル。署名者が採用するまでは`null`です。 properties: method: type: string enum: - typed - drawn description: '`typed`：認証済みの氏名を手書き風の書体で表示したもの。`drawn`：指またはマウスで描いたもの。' font: type: string nullable: true description: 入力した署名の筆跡スタイルです。手書きの場合は`null`です。 adopted_at: type: string format: date-time electronic_signature_consent_at: type: string format: date-time nullable: true description: 署名者がレビュー画面で、書類に電子的に署名することに同意した日時。いずれかの書類にフィールドがある場合に設定されます。 evidence_file: type: string nullable: true description: >- 署名後の証跡PDFのパス。[署名の証跡をダウンロード](/ja/sessions-api/electronic-signature/download-evidence)を参照してください。 warnings: type: array description: >- この署名者に対して発生した警告。[電子署名の警告](/ja/core-technology/electronic-signature/warnings-electronic-signature)を参照してください。 items: type: object properties: code: type: string enum: - SIGNATURE_DECLINED - SIGNATURE_OTP_FAILED - SIGNATURE_NAME_MISMATCH - SIGNATURE_IDENTITY_NOT_VERIFIED - SIGNATURE_DOCUMENT_CHANGED - SIGNATURE_FIELD_DATA_MISSING node_id: type: string validation: type: object nullable: true description: >- 署名済み書類の最後の暗号学的チェックです。書類が署名されるまでは`null`です。Diditが署名の結果を確認できない場合は`{"valid": null, "reason": "signature_provider_outcome_unknown", "checked_at": ...}`となり、`status`は`signing`のままです。この場合は未署名として扱ってください。 properties: valid: type: boolean nullable: true description: すべての書類が有効な場合は`true`です。署名の結果を確認できなかった場合は`null`です。 reason: type: string description: '`valid`が`null`の場合に設定されます：`signature_provider_outcome_unknown`。' checked_at: type: string format: date-time documents: type: array items: type: object properties: id: type: string format: uuid checked_at: type: string format: date-time valid: type: boolean description: 署名とタイムスタンプがともに有効かつ信頼できる場合は`true`です。 integrity: type: boolean description: 署名後に書類が変更されていない場合は`true`です。 trusted: type: boolean description: 署名証明書が信頼されたルートまでチェーンしている場合は`true`です。 revoked: type: boolean trusted_list: type: object description: >- EUトラステッドリストのチェック。AESの場合：`{"status": "not_applicable", "reason": "aes_not_qualified"}`。 properties: status: type: string reason: type: string certificate: type: object nullable: true description: 書類の署名に使用された証明書。署名されるまでは`null`で、Simple署名の場合は常に`null`です。 properties: issuer: type: string issued_to: type: string serial: type: string description: シリアル番号（16進数）。 valid_from: type: string format: date-time valid_until: type: string format: date-time timestamp: type: object nullable: true description: >- 署名に含まれるRFC 3161タイムスタンプで、Diditが発行します。署名されるまでは`null`で、Simple署名では常に`null`です。 properties: time: type: string format: date-time qualified: type: boolean description: AESの場合は常に`false`です。 valid: type: boolean declined_at: type: string format: date-time nullable: true declined_action: type: string enum: - DECLINE - REVIEW - NO_ACTION signed_at: type: string format: date-time nullable: true expires_at: type: string format: date-time description: 署名リンクが機能しなくなる日時。 email_sent_at: type: string format: date-time nullable: true email_unavailable_reason: type: string nullable: true ip_address: type: string nullable: true description: 署名者がコードをリクエストしたときのIPアドレス。 place: type: string nullable: true description: '収集されません: 常に`null`です。' place_unavailable_reason: type: string nullable: true enum: - not_collected AMLScreening: type: object properties: node_id: type: string description: ワークフローグラフ内のこのAMLステップの一意の識別子。 status: type: string description: >- このAMLスクリーニングの機能レベルのステータスです。トップレベルのセッションの`status`とは独立しています。個々の機能が`In Review`のままでも、セッション全体の判定が確定する場合があります。 enum: - Not Finished - Approved - Declined - In Review - Resub Requested total_hits: type: integer description: 見つかった一致の総数 entity_type: type: string description: スクリーニング対象のエンティティの種類：個人または法人 hits: type: array items: type: object properties: id: type: string description: >- ヒットに対するDiditの安定した識別子で、`hit_`の後に16進数24文字が続きます。対象者を再度スクリーニングした場合も、一致した同じエンティティは同じ`id`を保持します。AMLヒットレビューのエンドポイントには`hit_id`として渡してください。 url: type: string format: uri description: 一致のソースURL match: type: boolean description: 確定した一致かどうか score: type: number format: float nullable: true minimum: 0 maximum: 1 description: >- 非推奨の0〜1の範囲の加重一致スコア（例: `0.73`）。代わりに`match_score`（0〜100）を使用してください。 deprecated: true target: type: boolean nullable: true description: 一致したエンティティが、掲載の直接の対象(関係者ではなく)かどうか。情報源が明示していない場合は`null`です。 caption: type: string description: 一致項目のキャプションまたはタイトル datasets: type: array items: type: string enum: - PEP - PEP Level 1 - PEP Level 2 - PEP Level 3 - PEP Level 4 - Sanctions - Adverse Media - Warnings and Regulatory Enforcement - Fitness and Probity - SIP - SIE - Insolvency - Other Lists description: >- 一致が見つかったデータセットカテゴリーのリストです。エンティティがPEPリスト（レベル付き）、制裁データベース、ネガティブメディア、警告・規制執行、またはその他のコンプライアンスデータセットに掲載されていたかを示します。エンティティのソースにこれらのカテゴリーがいずれも記載されていない場合は`Other Lists`になります。 features: type: object nullable: true description: 一致に関する追加の特徴 rca_name: type: string description: 該当する場合はRCAの名前 last_seen: type: string format: date-time description: 一致が最後に確認された日付 risk_view: type: object properties: crimes: type: object properties: score: type: integer weightage: type: integer risk_level: type: string risk_scores: type: object countries: type: object properties: score: type: integer weightage: type: integer risk_level: type: string risk_scores: type: object categories: type: object properties: score: type: integer weightage: type: integer risk_level: type: string risk_scores: type: object custom_list: type: object first_seen: type: string format: date-time description: 一致が最初に確認された日付 properties: type: object properties: name: type: array items: type: string alias: type: array items: type: string notes: type: array items: type: string title: type: string nullable: true gender: type: array items: type: string height: type: string nullable: true topics: type: string nullable: true weight: type: string nullable: true address: type: string nullable: true country: type: string nullable: true website: type: string nullable: true eyeColor: type: string nullable: true keywords: type: string nullable: true lastName: type: array items: type: string position: type: string nullable: true religion: type: string nullable: true birthDate: type: array items: type: string education: type: array items: type: string ethnicity: type: string nullable: true firstName: type: array items: type: string hairColor: type: string nullable: true weakAlias: type: string nullable: true birthPlace: type: array items: type: string modifiedAt: type: string nullable: true wikidataId: type: string nullable: true citizenship: type: string nullable: true nationality: type: string nullable: true match_score: type: number description: >- 氏名の類似度、生年月日、国の一致から算出される加重アイデンティティ信頼度スコア（0-100）。ヒットが誤検知（False Positive）か一致の可能性あり（Possible Match）かの判定に使用されます。 format: float nullable: true risk_score: type: number description: >- エンティティのリスクスコア（0-100）。誤検知ではないヒットのうち最も高いrisk_scoreに基づいて、最終的なAMLステータス（承認済み/レビュー中/却下）を判定するために使用されます。 review_status: type: string description: >- このヒットのレビューステータス。'Unreviewed'、'Confirmed Match'、'False Positive'、'Inconclusive'のいずれかです。 enum: - Unreviewed - Confirmed Match - False Positive - Inconclusive score_breakdown: type: object description: match_scoreの算出方法の詳細な内訳。 properties: name_score: type: integer description: 名前の生の類似度パーセンテージ（0-100）。 name_weight: type: integer description: 設定における氏名の元の重み（0-100）です。 name_weight_normalized: type: number description: 欠損データに応じて再重み付けした後の、氏名の正規化された重み（0-100）。 name_contribution: type: number description: 名前が合計スコアに寄与したポイント。 dob_score: type: integer description: 生年月日の一致スコア（-100〜100）。 dob_weight: type: integer description: 設定における生年月日の元の重み（0-100）です。 dob_weight_normalized: type: number description: 欠損データに応じて再重み付けした後の、生年月日の正規化された重み（0-100）。 dob_contribution: type: number description: 生年月日が合計スコアに寄与したポイント。 country_score: type: integer description: 国の一致スコア（-100〜100）。 country_weight: type: integer description: 設定における国の元の重み（0-100）です。 country_weight_normalized: type: number description: 欠損データに応じて再重み付けした後の、国の正規化された重み（0-100）。 country_contribution: type: number description: 国が合計スコアに寄与したポイント。 document_number_match_type: type: string description: 書類番号の「Golden Key」評価の結果。 enum: - MATCH - NEUTRAL - HARD_MISMATCH document_number_effect: type: string description: 書類番号がスコアに与える影響を人が読める形で説明したもの。 total_score: type: integer description: 最終的な加重一致スコア（0-100）です。 pep_matches: type: array items: type: object properties: aliases: type: array items: type: string education: type: array items: type: string list_name: type: string publisher: type: string source_url: type: string format: uri description: type: string matched_name: type: string pep_position: type: string date_of_birth: type: string other_sources: type: array items: type: string place_of_birth: type: string linked_entities: type: array items: type: object properties: name: type: array items: type: string active: type: array items: type: string status: type: array items: type: string details: type: array items: type: string relation: type: array items: type: string warning_matches: type: array description: >- 警告および規制執行との一致のリストです。Warning、SIP、Warnings and Regulatory Enforcement、Fitness and Probity、SIE、Insolvencyの各カテゴリーのエントリが含まれます。 items: type: object properties: list_name: type: string description: 警告リストの公開元の名称 matched_name: type: string description: 警告リストで一致した名前 description: type: string description: 警告エントリの説明 publisher: type: string description: 警告の発行元または情報源 source_url: type: string format: uri description: 警告の情報源へのURL other_sources: type: array items: type: string description: 追加のソースURL countries: type: array items: type: string nullable: true description: 警告に関連する国 created_at: type: string nullable: true description: 警告エントリの作成日 updated_at: type: string nullable: true description: 警告エントリの最終更新日 additional_data: type: object description: >- 警告ソースからの追加データ。`case_details`配列を含む`data`オブジェクトが含まれる場合があります。 properties: data: type: object properties: case_details: type: array description: この一致に関連する警告ケースの詳細 items: type: object properties: case_type: type: string description: 警告ケースの種類 enum: - Accusation - Arrest - Bribery - Criminal - Fraud - Illegal Fundraising - Non-conviction Terror - Proclaimed Offender - Regulatory Enforcement - Terrorism - Terrorism-related - Terrorism-related listing sanction_matches: type: array description: このエンティティについて見つかった制裁リストとの一致のリストです。 items: type: object properties: list_name: type: array items: type: string nullable: true description: 制裁リストの名称 matched_name: type: string description: 制裁リストで一致した名前 description: type: string description: 制裁エントリの説明 reason: type: string nullable: true description: >- エンティティが制裁対象となった理由の自由記述。制裁リストの理由エントリーを結合したものです。例: 'Executive Order 13224 (Terrorism)'、'Support for actions undermining Ukraine's sovereignty'、'Listed due to national security concerns.' source_url: type: string format: uri description: 制裁の情報源へのURL other_sources: type: array items: type: string description: 追加のソースURL details: type: array items: type: string description: 制裁に関する追加の詳細 legal_basis: type: array items: type: string description: 制裁の法的根拠 listed_on: type: array items: type: string nullable: true description: エンティティがリストに掲載された日付 sanction_list: type: array items: type: string nullable: true description: 制裁リストの識別子 sanction_program: type: array items: type: string description: エンティティが掲載されている制裁プログラム sanctioning_authority: type: array items: type: string description: 制裁を科した当局 updated_on: type: array items: type: string description: 制裁エントリが最後に更新された日付 additional_data: type: object description: 主要フィールドに含まれない、制裁ソースからの追加データ adverse_media_details: type: object properties: sentiment: type: string entity_type: type: string sentiment_score: type: integer adverse_keywords: type: object additionalProperties: type: integer adverse_media_matches: type: array items: type: object properties: country: type: string summary: type: string headline: type: string sentiment: type: string thumbnail: type: string format: uri source_url: type: string format: uri author_name: type: string nullable: true other_sources: type: array items: type: string adverse_keywords: type: array items: type: string sentiment_score: type: integer publication_date: type: string format: date-time additional_information: type: object score: type: number format: float nullable: true minimum: 0 maximum: 100 description: >- AMLスクリーニングの総合スコア。すべてのヒットの中で最も高いリスクスコア（float、0-100）です。算出されるまでは`null`です。 screened_data: type: object properties: full_name: type: string nationality: type: string date_of_birth: type: string format: date document_number: type: string nullable: true is_ongoing_monitoring_enabled: type: boolean description: >- このスクリーニングで継続的なAMLモニタリングが有効かどうかです。`true`の場合、エンティティは定期的に再スクリーニングされ、新たなヒットがあればレポートが更新されます。 next_ongoing_monitoring_bill_date: type: string format: date nullable: true description: >- この継続的なモニタリングのサブスクリプションが次回請求される日付（YYYY-MM-DD）。`is_ongoing_monitoring_enabled = true`の場合、最後に継続的なモニタリングが請求された日付に365日を加えて算出されます。それ以外の場合は`null`です。これは請求日であり、スクリーニング日ではありません。スクリーニング日には`last_ongoing_screening_at`を使用してください。 last_ongoing_screening_at: type: string format: date-time nullable: true description: >- 継続的なモニタリングがこのレコードの再スクリーニングを最後に完了した日時。結果が変わったかどうかは問いません。レコードが一度も再スクリーニングされていない場合は`null`で、有効化日や請求日から遡って設定されることはありません。 last_ongoing_screening_datasets_updated_at: type: string format: date-time nullable: true description: >- そのスクリーニングの時点でプロバイダーが報告した、最新のAMLデータセット更新日です。プロバイダーがデータセットの日付を報告しなかった場合は`null`となり、推定されることはありません。 warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。AMLスクリーニング内では通常`AML`ですが、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID GeolocationCheck: type: object description: >- 1件の位置情報検証結果で、1つのワークフローノードで受理された試行です。測定値、不確実性、真正性は別々のキーであるため、精度は高いが証明されていない測位と、精度は低いが証明された測位は異なる内容として読み取れます。 properties: node_id: type: string nullable: true description: この結果を生成したワークフローノード。これにより、位置情報検証ステップを2つ持つワークフローでも結果を判別できます。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: この位置情報検証ステップの機能レベルのステータスで、その警告に基づいて決定されます。セッションの`status`とは独立しています。 outcome: type: string nullable: true description: この試行で発生した内容。 enum: - verified - low_accuracy - accuracy_undetermined - stale - approximate - denied - restricted - unavailable - timeout - mock_detected - outside_geofence - in_blocked_area - anonymizer_detected - skipped - replay_rejected - unsupported_client - null permission: type: string nullable: true description: >- OSまたはブラウザーが付与した権限です。`not_requested`は、ステップが接続のIP位置情報のみを使用することを意味するため、本人に権限を求めることはありません。 enum: - granted_precise - granted_approximate - denied - restricted - unavailable - timeout - dismissed - not_requested - null latitude: type: number nullable: true description: 測位結果のWGS84緯度。測位結果がない場合は`null`です。 format: double longitude: type: number nullable: true description: 測位結果のWGS84経度。測位結果がない場合は`null`です。 format: double accuracy_m: type: number nullable: true description: '`accuracy_confidence`の信頼水準における不確かさの半径（メートル単位）。' format: double accuracy_confidence: type: string nullable: true description: >- プラットフォームが`accuracy_m`に付与する信頼水準：`p95`（ブラウザ）、`p68`（Android）、または`unspecified`（iOS）。 enum: - p95 - p68 - unspecified - null measured_at: type: string nullable: true description: デバイスが位置情報を取得した日時（デバイス自身の時計による）。 format: date-time age_seconds: type: integer nullable: true description: デバイスが位置情報を取得してからDiditが受信するまでの秒数。 source: type: string nullable: true description: 位置情報の取得元（プラットフォームが提供する場合）。`ip`は、位置が接続のIPロケーションであることを示します。 enum: - gps - fused - network - wifi - cell - browser - unknown - ip - null platform: type: string nullable: true description: 測位結果を生成したクライアント。 enum: - web - ios - android - react_native - flutter - null sdk_version: type: string nullable: true description: 測位結果を生成したSDKのバージョン。 is_mock: type: boolean nullable: true description: >- 位置情報が模擬位置情報プロバイダーまたはシミュレーションソフトウェアから取得されたとデバイスが報告した場合は`true`です。プラットフォームがこれを報告しない場合（ブラウザでは判別できません）は`null`になります。`null`は`false`を意味しません。 produced_by_accessory: type: boolean nullable: true description: iOSのみ：位置情報が外部アクセサリーから取得された場合は`true`。それ以外の環境では`null`。 integrity: type: string enum: - attested - not_attested - failed - unsupported - not_determined description: >- デバイスアテステーションによって位置情報が裏付けられているかどうかです。Webにはアテステーションの仕組みがないため、ブラウザは`unsupported`を報告します。これは失敗ではありません。 country_code: type: string nullable: true description: 測位地点が所在する国を示すISO 3166-1 alpha-2コード。 region_code: type: string nullable: true description: 測位地点が属するISO 3166-2地域区分。 city: type: string nullable: true description: 最寄りの居住地。レビュアー向けのラベルです。 geofence: type: object description: ステップの国および地域ルールの結果。 properties: enabled: type: boolean description: ステップが国または地域のルールを適用しているかどうか。 result: type: string nullable: true description: >- ルールに対する位置の関係です。`undetermined`は、精度円が境界をまたいでいるか、位置がどの国にも特定されなかったことを意味します。これは外側にいることの証拠ではありません。 enum: - inside - outside - undetermined - null inside_geofence: type: boolean nullable: true description: >- `geofence.result`が`inside`の場合は`true`、`outside`の場合は`false`、それ以外の場合は`null`です。 geofence_basis: type: string nullable: true description: エリア判定の基準とした位置：`device`の測位、または接続の`ip`の位置情報。 enum: - device - ip - null inside_areas: type: array items: type: string description: 位置が含まれる、設定済みの許可エリアのID。 blocked_areas: type: array items: type: string description: 位置が含まれる、設定済みのブロック対象エリアのID。 position_source: type: string nullable: true description: 設定に基づいてステップが位置を取得する元です。IP位置情報と照合したデバイス、デバイスのみ、またはIP位置情報のみのいずれかです。 enum: - device_and_ip - device_only - ip_only - null anonymizers: type: object nullable: true description: 接続とデバイスの状態です。各項目は`true`、`false`、またはソースが判別できない場合は`null`です。 properties: vpn: type: boolean nullable: true proxy: type: boolean nullable: true tor: type: boolean nullable: true spoofing: type: boolean nullable: true emulator: type: boolean nullable: true ip_distance_km: type: number nullable: true description: 両方の不確実性半径を差し引いた後の、セッションのIP位置情報までの距離。両者が重なる場合は`0`。 format: double ip_distance_uncertainty_km: type: number nullable: true description: '差し引かれた合計半径: IP位置の半径にこの測位の精度を加えた値。' format: double ip_consistent: type: boolean nullable: true description: '`ip_distance_km`がステップで設定された距離以内かどうかです。いずれかが不明な場合は`null`です。' document_distance_km: type: number nullable: true description: 身分証明書または住所証明の書類に記載された住所をジオコーディングした地点までの距離。登録済みの住所がない場合は`null`。 format: double travel_excused: type: boolean nullable: true description: ステップの移動許容範囲によって住所からの距離が許容されたかどうか。許容範囲がオフの場合は`null`です。 consecutive_mismatches: type: integer nullable: true description: '最終試行時: このチェックに、同一人物のそれ以前の連続した不一致を加えた数。' attempts: type: integer description: ノード内でのこの試行の番号です。1から始まります。 consent: type: object nullable: true description: システムプロンプトの前に本人が与えた同意。本人が見た文言のバージョンと言語とともに記録されます。 properties: accepted_at: type: string format: date-time version: type: string nullable: true locale: type: string nullable: true warnings: type: array items: type: object properties: feature: type: string enum: - ID_VERIFICATION - NFC - LIVENESS - FACEMATCH - PROOF_OF_ADDRESS - PHONE - EMAIL - AML - LOCATION - DATABASE_VALIDATION - QUESTIONNAIRE - DOCUMENT_AI - KYB_REGISTRY - KYB_DOCUMENTS - KYB_KEY_PEOPLE - GEOLOCATION - SIGNATURE description: >- この警告を生成した機能です。この値は、警告が属する機能ブロックを示します。各モジュールのwarnings配列では通常そのモジュールに対応する値が使われます（例: `phone_verifications[].warnings`内の`PHONE`）が、判定ペイロード上のすべての機能の警告については、上記のenumが正式な定義です。 risk: type: string additional_data: type: object nullable: true log_type: type: string short_description: type: string long_description: type: string node_id: type: string description: この警告を生成したワークフローグラフのノードID description: >- この位置情報検証ステップで発生した警告。`feature`は`GEOLOCATION`に設定されます。警告コードは`LOCATION_`で始まります。 GeolocationAttempt: type: object description: >- 位置情報検証ステップの1回の試行。`warnings`を除き`geolocation_checks[]`と同じキーを持ち、さらにDiditが受信した日時を含みます。 properties: node_id: type: string nullable: true description: この結果を生成したワークフローノード。これにより、位置情報検証ステップを2つ持つワークフローでも結果を判別できます。 status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: この位置情報検証ステップの機能レベルのステータスで、その警告に基づいて決定されます。セッションの`status`とは独立しています。 outcome: type: string nullable: true description: この試行で発生した内容。 enum: - verified - low_accuracy - accuracy_undetermined - stale - approximate - denied - restricted - unavailable - timeout - mock_detected - outside_geofence - in_blocked_area - anonymizer_detected - skipped - replay_rejected - unsupported_client - null permission: type: string nullable: true description: >- OSまたはブラウザーが付与した権限です。`not_requested`は、ステップが接続のIP位置情報のみを使用することを意味するため、本人に権限を求めることはありません。 enum: - granted_precise - granted_approximate - denied - restricted - unavailable - timeout - dismissed - not_requested - null latitude: type: number nullable: true description: 測位結果のWGS84緯度。測位結果がない場合は`null`です。 format: double longitude: type: number nullable: true description: 測位結果のWGS84経度。測位結果がない場合は`null`です。 format: double accuracy_m: type: number nullable: true description: '`accuracy_confidence`の信頼水準における不確かさの半径（メートル単位）。' format: double accuracy_confidence: type: string nullable: true description: >- プラットフォームが`accuracy_m`に付与する信頼水準：`p95`（ブラウザ）、`p68`（Android）、または`unspecified`（iOS）。 enum: - p95 - p68 - unspecified - null measured_at: type: string nullable: true description: デバイスが位置情報を取得した日時（デバイス自身の時計による）。 format: date-time age_seconds: type: integer nullable: true description: デバイスが位置情報を取得してからDiditが受信するまでの秒数。 source: type: string nullable: true description: 位置情報の取得元（プラットフォームが提供する場合）。`ip`は、位置が接続のIPロケーションであることを示します。 enum: - gps - fused - network - wifi - cell - browser - unknown - ip - null platform: type: string nullable: true description: 測位結果を生成したクライアント。 enum: - web - ios - android - react_native - flutter - null sdk_version: type: string nullable: true description: 測位結果を生成したSDKのバージョン。 is_mock: type: boolean nullable: true description: >- 位置情報が模擬位置情報プロバイダーまたはシミュレーションソフトウェアから取得されたとデバイスが報告した場合は`true`です。プラットフォームがこれを報告しない場合（ブラウザでは判別できません）は`null`になります。`null`は`false`を意味しません。 produced_by_accessory: type: boolean nullable: true description: iOSのみ：位置情報が外部アクセサリーから取得された場合は`true`。それ以外の環境では`null`。 integrity: type: string enum: - attested - not_attested - failed - unsupported - not_determined description: >- デバイスアテステーションによって位置情報が裏付けられているかどうかです。Webにはアテステーションの仕組みがないため、ブラウザは`unsupported`を報告します。これは失敗ではありません。 country_code: type: string nullable: true description: 測位地点が所在する国を示すISO 3166-1 alpha-2コード。 region_code: type: string nullable: true description: 測位地点が属するISO 3166-2地域区分。 city: type: string nullable: true description: 最寄りの居住地。レビュアー向けのラベルです。 geofence: type: object description: ステップの国および地域ルールの結果。 properties: enabled: type: boolean description: ステップが国または地域のルールを適用しているかどうか。 result: type: string nullable: true description: >- ルールに対する位置の関係です。`undetermined`は、精度円が境界をまたいでいるか、位置がどの国にも特定されなかったことを意味します。これは外側にいることの証拠ではありません。 enum: - inside - outside - undetermined - null inside_geofence: type: boolean nullable: true description: >- `geofence.result`が`inside`の場合は`true`、`outside`の場合は`false`、それ以外の場合は`null`です。 geofence_basis: type: string nullable: true description: エリア判定の基準とした位置：`device`の測位、または接続の`ip`の位置情報。 enum: - device - ip - null inside_areas: type: array items: type: string description: 位置が含まれる、設定済みの許可エリアのID。 blocked_areas: type: array items: type: string description: 位置が含まれる、設定済みのブロック対象エリアのID。 position_source: type: string nullable: true description: 設定に基づいてステップが位置を取得する元です。IP位置情報と照合したデバイス、デバイスのみ、またはIP位置情報のみのいずれかです。 enum: - device_and_ip - device_only - ip_only - null anonymizers: type: object nullable: true description: 接続とデバイスの状態です。各項目は`true`、`false`、またはソースが判別できない場合は`null`です。 properties: vpn: type: boolean nullable: true proxy: type: boolean nullable: true tor: type: boolean nullable: true spoofing: type: boolean nullable: true emulator: type: boolean nullable: true ip_distance_km: type: number nullable: true description: 両方の不確実性半径を差し引いた後の、セッションのIP位置情報までの距離。両者が重なる場合は`0`。 format: double ip_distance_uncertainty_km: type: number nullable: true description: '差し引かれた合計半径: IP位置の半径にこの測位の精度を加えた値。' format: double ip_consistent: type: boolean nullable: true description: '`ip_distance_km`がステップで設定された距離以内かどうかです。いずれかが不明な場合は`null`です。' document_distance_km: type: number nullable: true description: 身分証明書または住所証明の書類に記載された住所をジオコーディングした地点までの距離。登録済みの住所がない場合は`null`。 format: double travel_excused: type: boolean nullable: true description: ステップの移動許容範囲によって住所からの距離が許容されたかどうか。許容範囲がオフの場合は`null`です。 consecutive_mismatches: type: integer nullable: true description: '最終試行時: このチェックに、同一人物のそれ以前の連続した不一致を加えた数。' attempts: type: integer description: ノード内でのこの試行の番号です。1から始まります。 consent: type: object nullable: true description: システムプロンプトの前に本人が与えた同意。本人が見た文言のバージョンと言語とともに記録されます。 properties: accepted_at: type: string format: date-time version: type: string nullable: true locale: type: string nullable: true received_at: type: string nullable: true description: Diditが試行を受信した日時です。 format: date-time created_at: type: string format: date-time KYBRegistryShareholding: type: object nullable: true description: >- 所有者が保有するもの。すべての国と登記情報ソースで同じ形式です。登記に保有の記載がない場合はnullです。範囲（例: 英国PSCの25-50%）は持分ではありません。`percentage`はnullとなり、範囲は`ownership_min_shares` / `ownership_max_shares`に保持されます。 properties: share_class: type: string nullable: true description: 登記簿上の名称どおりの株式のクラスまたは種類。 number_of_shares: type: number nullable: true description: 保有株式数です。 currency: type: string nullable: true description: 以下の値のISO 4217通貨。 nominal_value: type: number nullable: true description: 1株あたりの額面金額。 total_value: type: number nullable: true description: 保有資産の合計額。 percentage: type: number nullable: true description: パーセント単位の正確な出資比率で、小数点以下4桁までです。 required: - share_class - number_of_shares - currency - nominal_value - total_value - percentage KYBRegistryAddress: type: object description: 登記に記載された住所。国や登記ソースを問わず同じ形式です。すべてのキーが常に存在し、登記で公開されていない部分はnullになります。 properties: type: type: string nullable: true description: >- 小文字の住所種別です。登記上の本店所在地は`registered`、その他の種別は登記機関での名称のとおりです（例:`postal`、`office`）。登記機関が住所の種別を示していない場合は`null`です。 address: type: string description: 1行で表した住所全体です。すべての住所に必ず含まれます。 street: type: string nullable: true description: 通り名と番地。 city: type: string nullable: true description: 都市または地域。 postal_code: type: string nullable: true description: 郵便番号。 region: type: string nullable: true description: 地域、州、または県。 country_code: type: string nullable: true description: ISO 3166-1 alpha-2国コード。 description: type: string nullable: true description: 登記上の住所のラベル（登記側が提供する場合）。 required: - type - address - street - city - postal_code - region - country_code - description KYBRegistryIndustry: type: object description: 登記上で企業が分類されている事業活動。国や登記ソースを問わず同じ形式です。 properties: code: type: string nullable: true description: '登記簿に記載されているとおりの事業コード（例: `73110`）。' description: type: string nullable: true description: 登記機関が公開している場合、事業のラベル。 scheme: type: string nullable: true description: >- 分類体系。どのソースが報告したかにかかわらず、体系ごとに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: type: boolean description: 企業の主要事業の場合はtrue。リストが空でない場合、primaryとなるエントリは必ず1つだけです。 required: - code - description - scheme - is_primary KYBRegistryData: type: object nullable: true description: >- Diditが正規化した企業の登記詳細です。所有構造の結果（`ownership_error`、`section_errors`、`ubo_resolution`、`lite_enrichment`）、update-dataで行われた修正、および専用のフィールドを持たない登記上の事実が含まれます。登記情報源自体のレコードが含まれることはありません。すべてのキーは任意で、企業にその値がある場合にのみ存在します。新しいキーが追加される場合があります。正規フィールド（`addresses`、`industries`、`ownership`、`beneficial_owners[].shareholding`）が扱う内容については、それらのフィールドを参照してください。 properties: company_name: type: string description: コンソールで修正された会社名。 registration_number: type: string description: 登記所またはコンソールでの修正に記載されている登記番号。 country_code: type: string description: 登記機関またはコンソールでの修正内容に記載された登録国。 region: type: string description: 登記の地域または州。 incorporation_date: type: string description: 設立日（ISO 8601）。 registration_date: type: string description: 登記所が設立日とは別に登録日を記載している場合の登録日（ISO 8601）。 dissolution_date: type: string description: 登記に記載がある場合の解散日(ISO 8601)。 tax_number: type: string description: 納税者番号。 vat_number: type: string description: VAT番号。 legal_address: type: string description: コンソールで修正された法定住所。 registered_address: type: string description: 登記所に記載されているとおりの登記住所。 company_type: type: string description: 法人形態。 registry_status: type: string description: 登記上の企業ステータス。 verification_status: type: string description: 認証ステータス。 alternative_names: type: string description: 企業が現在または過去に使用している商号です。 nature_of_business: type: string description: 事業内容の説明。 registered_capital: type: string description: 記載どおりの資本金。 registered_capital_amount: type: string description: 資本金の額（10進数の文字列）。 registered_capital_currency: type: string description: 資本金の通貨（ISO 4217）。 website: type: string description: Webサイト。 email: type: string description: 連絡先メールアドレス。 phone: type: string description: 連絡先電話番号。 legal_entity_identifier: type: string description: 取引主体識別子(LEI)。 location_of_registration: type: string description: 登録地。 control_scheme: type: string description: 登記機関が公開している場合のガバナンス体制。 ownership_error: type: string enum: - 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 description: >- 要求された所有構造のレベルが提供されなかった理由で、`ownership.unavailable_reason`と同じコードを使用します。`no_owners_on_record`（登記機関は応答したが所有者が記載されていない）と`ownership_section_unavailable`（登記機関が所有構造のセクションを返さなかった）は異なる結果です。 section_errors: type: object description: >- 登記所が返さなかったセクションで、セクション(`officers`、`shareholders`、`group_structure`)をキーとします。ここに記載されたセクションは一度も配信されていません。そのセクションの空のリストは、企業について何も示すものではありません。 additionalProperties: $ref: '#/components/schemas/KYBRegistrySectionError' ubo_resolution: $ref: '#/components/schemas/KYBRegistryUboResolution' lite_enrichment: $ref: '#/components/schemas/KYBRegistryLiteEnrichment' registry_metadata: type: object additionalProperties: oneOf: - type: string - type: number - type: boolean description: >- 登記簿上の企業のフィールド。登記簿での名称をキーとし、プレーンな値で示されます（レガシーレコード）。登記上の事実としてレビューされたフィールドのみが含まれます。 registry_sources: type: array description: レコードの読み取り元となった公式登記簿（従来のレコード）。その他のソースは明示されません。 items: $ref: '#/components/schemas/KYBRegistrySource' previous_names: type: array items: type: string description: 会社が以前に登録されていた名称（過去の記録）。 parent_companies: type: array items: type: string description: 登記に記載されている親会社(旧形式のレコード)。 documents_available: type: integer description: 登記機関がこの企業について提供している提出書類の数（過去の記録）。 KYBRegistryOwnership: type: object description: 所有構造（株主／UBO）レベルの結果。国や登記ソースにかかわらず同じ形式です。 properties: status: type: string nullable: true enum: - not_requested - pending - delivered - not_held - unavailable - null description: >- 登記簿が所有構造を公開した場合は`delivered`、所有構造の登記簿が応答したもののこの企業がまったく掲載されていない場合は`not_held`（`unavailable_reason`を参照）、その他の理由で所有構造データが提供されなかった場合は`unavailable`（`unavailable_reason`を参照）、登記簿がまだ取得中の場合は`pending`、Basicレベルでは`not_requested`です。 tier_requested: type: string nullable: true enum: - basic - shareholders - ubo - null description: ワークフローが注文したレベル。 tier_delivered: type: string nullable: true enum: - basic - shareholders - ubo - null description: 登記機関が提供したレベル（請求対象となるレベル）。直接の株主のみで回答されたUBOリクエストは`shareholders`になります。 unavailable_reason: type: string nullable: true enum: - 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 description: >- 要求された所有構造のレベルが提供されなかった理由です。`status`が`unavailable`または`pending`でない限りnullです。 direct_ownership_complete: type: boolean nullable: true description: >- 直接株主の記載された持分の合計が100%になる場合（端数処理による1パーセントポイント以内の差を含む）はtrue、ならない場合はfalse、所有構造が提供されていないか、記載されていない持分がある場合はnull。 unresolved: type: array description: 法人登記で解決できなかった所有構造チェーンの部分。たとえば、直接の所有者より上位のグループ構造が記録されていない場合です。 items: type: object properties: reason: type: string section: type: string nullable: true required: - status - tier_requested - tier_delivered - unavailable_reason - direct_ownership_complete - unresolved KYBOwnershipStructure: type: object nullable: true description: >- 所有構造レベルが提供された時点で登記情報により証明された資本構成表。直接の`shareholders`と`beneficial_owners`を含みます。登記情報により所有構造が証明されなかった場合はnullです。登記ソース自体の行は含まれません。最新の記録は`company.beneficial_owners`と`company.ownership`を参照してください。 properties: shareholders: type: array items: $ref: '#/components/schemas/KYBOwnershipStructureOwner' beneficial_owners: type: array items: $ref: '#/components/schemas/KYBOwnershipStructureOwner' required: - shareholders - beneficial_owners InvestigatorBlock: type: object nullable: true description: >- 項目の最新のInvestigatorレビューです。レビューが一度もない場合はnullです。V3のセッションおよび企業セッションの判定に含まれます(したがって`status.updated`のWebhookにも含まれます)。 properties: run_id: type: string format: uuid status: type: string enum: - running - completed - failed stage: type: string enum: - shadow - live queue: type: string enum: - kyc - kyb - aml - transactions - cases is_open: type: boolean recommendation: type: string enum: - approve - decline - escalate - request nullable: true recommendation_detail: type: string nullable: true confidence: type: string enum: - high - moderate - low nullable: true summary: type: string nullable: true ready_to_accept: type: boolean prepared_at: type: string format: date-time nullable: true automated: type: boolean description: 後で判定が覆された場合でも、Investigatorが単独で判定しました。 decided_by: type: string enum: - investigator - member nullable: true decision: nullable: true allOf: - $ref: '#/components/schemas/InvestigatorDecision' type: object BiometricRetention: type: object description: このセッションのライブ生体データが削除される日時。 required: - jurisdictions - deletes_at properties: jurisdictions: type: array items: type: string description: 生体認証に関する規則でこの人物の削除期限を定めている米国の州のコード（州が不明な場合は`US`）。該当するものがない場合は空です。 deletes_at: type: string format: date-time nullable: true description: >- このセッションのライブ生体データ（顔画像とテンプレート）が削除される日付です。アプリケーションのデータ保持設定と、該当する場合は本人の法域における法的上限に基づいて決まります。まだ適用される日付がない場合は`null`です。 SocialFootprintPlatform: type: object properties: platform: type: string description: プラットフォーム識別子。 example: whatsapp category: type: string description: >- プラットフォームのカテゴリー。例: MESSAGING、SOCIAL_MEDIA、ECOMMERCE、PROFESSIONAL、EMAIL_PROVIDER。 example: MESSAGING scope: type: string enum: - global - local description: グローバルなプラットフォームの場合は`global`、地域限定のプラットフォームの場合は`local`。 example: global SocialFootprintCategorySummary: type: object properties: registered: type: integer nullable: true description: このカテゴリーのうち、登録が確認されたプラットフォーム。 example: 2 ratio: type: number format: float nullable: true description: そのカテゴリでチェックしたプラットフォームのうち、登録があるものの割合（0.0〜1.0）。 example: 0.6667 SocialFootprintProfile: type: object properties: name: type: string nullable: true description: プロフィール名。プラットフォームが公開している場合に返されます。 photo: type: string nullable: true description: プロフィール写真のURL。プラットフォームが公開している場合に返されます。 about: type: string nullable: true description: プロフィールの自己紹介文。プラットフォームが公開している場合に返されます。 privacy_status: type: string nullable: true enum: - PUBLIC - PRIVATE - null description: プロフィールの公開設定。プラットフォームが公開している場合に返されます。 business_account: type: boolean nullable: true description: プラットフォームが公開している場合、プロフィールがビジネスアカウントかどうか。 SignatureFieldResult: type: object description: >- 署名済み書類のフィールドと、この署名者のコピー上での値。[フィールド](/ja/core-technology/electronic-signature/report-electronic-signature#フィールド)を参照してください。 properties: key: type: string description: '`sign.field_values`で使用するフィールドのキーです。' type: type: string enum: - signature - initials - full_name - date_signed - text - checkbox - email - data role: type: string enum: - verified_person - legal_representative - key_people label: type: string page: type: integer description: ページ番号（1から）。Word文書の場合は、変換後のPDFのページです。 x: type: number description: 左端。ページ幅に対する割合で表します。 'y': type: number description: ページの高さに対する割合で表した上端。 width: type: number description: 幅。ページ幅に対する割合で指定します。 height: type: number description: 高さです。ページの高さに対する比率で指定します。 required: type: boolean value: nullable: true description: >- `text`、`email`、`full_name`、`date_signed`、`data`では文字列、`checkbox`ではブール値、署名またはイニシャルが適用されている場合は`true`です。空の場合は`null`です。 display_value: type: string nullable: true description: >- ページに刻印された値。日付はフィールドの`date_format`形式、チェックボックスは`Yes`または`No`、署名またはイニシャルは`Signed`です。 value_source: type: string nullable: true enum: - signer - identity - contact - company - session - metadata - api - signing_time - null description: >- 値の出所です。`signer`（署名者が入力、チェック、または適用したもの）、`identity`（検証済みのID）、`contact`（検証済みのメールアドレスまたは電話番号）、`company`（検証済みの企業）、`session`（`vendor_data`）、`metadata`、`api`（`sign.field_values`）、または`signing_time`（署名日）のいずれかです。 filled_at: type: string format: date-time nullable: true image_url: type: string nullable: true description: >- 署名とイニシャルのみ：適用された画像のパス。[署名画像をダウンロードする](/ja/sessions-api/electronic-signature/download-field-image)を参照してください。 value_unavailable_reason: type: string nullable: true enum: - source_empty - null description: >- 事前入力フィールドの値がセッション内になく、`signature_field_data_missing_action`により署名者がそのまま署名できた場合は`source_empty`です。 KYBRegistrySectionError: type: object description: 登記機関から返されなかったセクション。 properties: status_code: type: integer nullable: true description: レジストリがそのセクションについて回答したステータス。 required: - status_code KYBRegistryUboResolution: type: object description: UBOレベルが企業の上位にある所有構造の連鎖をどのようにたどったか。 properties: parent_chain: type: array description: 最終親会社から当該企業までの親会社。 items: $ref: '#/components/schemas/KYBRegistryGroupCompany' subsidiaries: type: array description: 企業グループ内で、その企業の直下にある企業。 items: $ref: '#/components/schemas/KYBRegistryGroupCompany' unresolved: type: array description: 法人登記で解決できなかったチェーンの部分（`ownership.unresolved`と同じエントリ）。 items: type: object properties: reason: type: string description: >- 理由。例：`no_group_structure_on_record`、`selected_company_not_in_group_structure`、`section_error`。 section: type: string nullable: true description: '対象のセクションです（例: `group_structure`）。' required: - reason - section required: - parent_chain - subsidiaries - unresolved KYBRegistryLiteEnrichment: type: object description: その国の別の登記ソースが補完した、Liteプロファイルの空欄フィールド。ソース名は示されません。 properties: fields: type: array items: type: string description: 入力された企業フィールド。 people_added: type: integer description: 追加された役員または所有者の数。 required: - fields - people_added KYBRegistrySource: type: object description: 記録の読み取り元である公式登記簿。名前が示されるのは政府の公式登記簿、規制当局、公式の識別子システムのみで、それ以外の情報源は省略されます。 properties: name: type: string description: '登記所の名称。例: `UK Companies House`。' source_type: type: string enum: - official description: 常に`official`です。 required: - name - source_type KYBOwnershipStructureOwner: type: object description: >- 所有構造スナップショットの所有者1名です。`company.beneficial_owners[]`と同じ登記上の身元と持分、およびその正規の`shareholding`を含みます。 properties: name: type: string nullable: true description: 登記に記載されているとおりの所有者名。 first_name: type: string nullable: true description: 自然人の名。登記機関に記載がある場合に返されます。 last_name: type: string nullable: true description: 自然人の場合の姓（登記簿に記載されている場合）。 date_of_birth: type: string nullable: true description: 登記簿で公開されている場合の生年月日（ISO 8601）。 country_of_birth: type: string nullable: true description: 登記機関が公開している場合の出生国。 company_name: type: string nullable: true description: 法人の所有者の場合の会社名。 registration_number: type: string nullable: true description: 法人所有者の場合の登記番号。 entity_type: type: string nullable: true enum: - person - company - null description: 所有者が自然人か企業か。 nationality: type: string nullable: true description: 登記簿に記載がある場合の国籍。 designation: type: string nullable: true description: 登記簿に記載されているとおりの所有者の肩書きまたは役割。 roles: type: array items: type: string description: 直接の保有者の場合は`shareholder`、実質的支配者の場合は`ubo`です。 ownership_min_shares: type: string nullable: true description: 持分の下限（パーセント）。正確な持分の場合は上限と同じ値になります。 ownership_max_shares: type: string nullable: true description: 持分の上限値（パーセント）。 voting_min_shares: type: string nullable: true description: 議決権の下限（パーセント）。 voting_max_shares: type: string nullable: true description: 議決権の上限値（パーセント）。 appointment_date: type: string nullable: true description: 保有または就任の開始日（ISO 8601）。 is_active: type: boolean nullable: true description: 以前の所有者の場合はfalseです。 shareholding: $ref: '#/components/schemas/KYBRegistryShareholding' required: - name - first_name - last_name - date_of_birth - country_of_birth - company_name - registration_number - entity_type - nationality - designation - roles - ownership_min_shares - ownership_max_shares - voting_min_shares - voting_max_shares - appointment_date - is_active - shareholding InvestigatorDecision: type: object description: >- 項目がInvestigatorキューからどのように外れたか。`decided_by`、`original_outcome`、`overrides`は承認およびオーバーライドのエンドポイントとレポートで返されます。セッション判定の`investigator`ブロックにはそれ以外のフィールドが含まれます。 properties: outcome: type: string enum: - accepted - edited - overridden - decided_elsewhere - automated description: >- `accepted`または`edited`は推奨に従ったことを示し（`edited`はナラティブを書き直したもの）、`overridden`は別のアクションを取ったこと、`decided_elsewhere`はレポートが開かれている間にInvestigatorの外で下された判定、`automated`はInvestigatorが自ら下した判定です。 action: type: string enum: - approve - decline - escalate - request actor_email: type: string nullable: true actor_name: type: string nullable: true override_category: type: string enum: - missing_context - needs_information - policy_differs - evidence_misread - other - '' nullable: true override_reason: type: string nullable: true final_status: type: string description: 判定後の項目のステータスです。 agreed: type: boolean description: 判定が推奨と一致したかどうか。 nullable: true decided_at: type: string format: date-time billed: type: boolean description: レビューは課金されました。 decided_by: type: string enum: - investigator - member original_outcome: type: object description: Investigatorが独自に下した判定で、その後のオーバーライドによって変更されません。チームが下した判定の場合はnullです。 properties: action: type: string final_status: type: string decided_at: type: string format: date-time nullable: true overrides: type: array description: Investigatorが独自に下した判定に対するすべてのオーバーライドを古い順に示します。 items: type: object properties: action: type: string actor_email: type: string nullable: true actor_name: type: string nullable: true override_category: type: string override_reason: type: string previous_status: type: string final_status: type: string agreed: type: boolean nullable: true overridden_at: type: string format: date-time KYBRegistryGroupCompany: type: object description: 企業グループに属する会社。法人登記上の識別情報で示されます。 properties: name: type: string nullable: true description: 会社名。 country_code: type: string nullable: true description: 登録国。 registration_number: type: string nullable: true description: 登記番号。 required: - name - country_code - registration_number securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.