> ## 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 > DiditのケースAPIで、1件のユーザーまたは企業に紐づくコンプライアンスケースを作成します。セッションや取引の添付、コンプライアンス担当者への割り当ても可能です。 ケース作成APIのプロンプト プロンプトをクリップボードにコピー \

\`Create a compliance case for my Didit application through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Open an investigation case. Every case is anchored to exactly one subject (a user or a business) - set it directly with "subject", or attach a session/transaction via "links" and let the subject be derived from its owner.

Request body (application/json):
\{
"title": "Manual - Jane Doe",                 // required
"blueprint": "",          // optional but recommended - drives content/routing
"priority": "HIGH",                             // optional, LOW|MEDIUM|HIGH, default MEDIUM
"due_at": "2026-08-01T00:00:00Z",              // optional
"tags": ["review"],                             // optional
"subject": {"type": "user", "uuid": ""},  // required unless links is given
"links": [{"entity_type": "transaction", "entity_uuid": ""}],  // optional
"assigned_to": ""                    // optional
}

Validation:
\- At least one of subject or links is required - a 400 with a clear message is returned otherwise.
\- Source is always "MANUAL" for API-created cases.

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"title": "Manual - Jane Doe", "blueprint": "", "subject": {"type": "user", "uuid": ""}}'

Response 201: the full CaseDetail object (uuid, case_number, status "OPEN", subject, blueprint, notes, events, links, checklist_items).

Failure modes:
\- 400 - neither subject nor links provided; subject/blueprint/assignee not found.
\- 401/403 - auth/permission errors.

Side effects: creates the case, seeds its checklist from the blueprint (if any), and logs a CREATED event.

For the full integration shape, see /integration/integration-prompt.`

\
貼り付け先 ケースは必ず1つの対象に紐付けて作成します。`subject`を直接指定するか、`links`を指定して、最初にリンクされたエンティティの所有者からDiditが対象を特定します。> [!TIP] > > `blueprint`がある場合は必ず指定してください。これによって、ケースページに表示されるセクション、解決時にメモが必須かどうか、エスカレーションまたは移管時にケースがどこに振り分けられるかが決まります。## 関連情報- [ケースの一覧取得](https://docs.didit.me/ja/management-api/cases/list.md) - [ケースの解決](https://docs.didit.me/ja/management-api/cases/resolve.md) - [ケースの作成（Console）](https://docs.didit.me/ja/console/case-management/creating-cases.md) ## OpenAPI ````yaml ja/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/ 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/organization/{organization_id}/application/{application_id}/cases/: post: tags: - Cases summary: ケースを作成 description: >- ちょうど1つの対象（ユーザーまたは企業）に紐づくケースを作成します。対象は直接指定するか、添付したセッション/取引のリンクから導出します。APIで作成したケースのソースは常に`MANUAL`です。 operationId: create_case parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: 組織のUUIDです。 - name: application_id in: path required: true schema: type: string format: uuid description: アプリケーションのUUID。 requestBody: required: true content: application/json: schema: type: object required: - title properties: title: type: string maxLength: 255 blueprint: type: string format: uuid nullable: true description: CaseBlueprintのUUID。ブループリントを使用しない場合は省略します。 priority: type: string enum: - LOW - MEDIUM - HIGH default: MEDIUM due_at: type: string format: date-time nullable: true tags: type: array items: type: string subject: type: object description: linksを指定しない場合は必須です。ケースのただ1つの対象者です。 properties: type: type: string enum: - user - business uuid: type: string format: uuid links: type: array description: >- 作成時に紐付けるセッション、企業セッション、取引。例: [{"entity_type": "transaction", "entity_uuid": "..."}]。subjectを省略した場合、subjectは最初のリンクの所有者から導出されます。 items: type: object assigned_to: type: string format: uuid nullable: true description: 即時に割り当てるユーザーのUUID。 review_duplicates: type: boolean default: false description: >- ケースを作成する前に既存の調査を再確認します。trueの場合、既存のケースがある対象者には、空でないseparate_incident_reasonが必要です。コンソールでは常にこの保護が有効です。省略した場合は、既存のAPIの動作が維持されます。 separate_incident_reason: type: string maxLength: 1000 source_context: $ref: >- #/components/schemas/CaseDuplicateCaseFraudSourceContextRequest example: title: Manual - Jane Doe blueprint: b1de0000-0000-4000-8000-000000000002 priority: HIGH subject: type: user uuid: 5b9a0000-0000-4000-8000-00000000f00d tags: - review responses: '201': description: ケースが作成されました。 content: application/json: schema: $ref: '#/components/schemas/CaseDetail' '400': description: subjectとlinksのどちらも指定されていない、またはsubject/blueprint/assigneeが見つかりませんでした。 content: application/json: schema: type: object '409': description: 重複レビューが有効で、別個のインシデントである理由なしに既存のケースが見つかりました。ケースは作成されていません。 security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"title": "Manual - Jane Doe", "blueprint": "b1de0000-0000-4000-8000-000000000002", "priority": "HIGH", "subject": {"type": "user", "uuid": "5b9a0000-0000-4000-8000-00000000f00d"}, "tags": ["review"]}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.cases.create( title="Manual - Jane Doe", blueprint="b1de0000-0000-4000-8000-000000000002", priority="HIGH", tags=["review"], subject={ "type": "user", "uuid": "5b9a0000-0000-4000-8000-00000000f00d", }, ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.cases.create({ title: "Manual - Jane Doe", blueprint: "b1de0000-0000-4000-8000-000000000002", priority: "HIGH", tags: ["review"], subject: { type: "user", uuid: "5b9a0000-0000-4000-8000-00000000f00d", }, }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Cases.Create(ctx, didit.CasesCreateParams{\n\tTitle: \"Manual - Jane Doe\",\n\tBlueprint: didit.String(\"b1de0000-0000-4000-8000-000000000002\"),\n\tPriority: didit.Some(didit.CasesCreateParamsPriority(\"HIGH\")),\n\tTags: didit.Some([]string{\"review\"}),\n\tSubject: didit.Some(didit.CasesCreateParamsSubject{\n\t\tType: didit.Some(didit.CasesCreateParamsSubjectType(\"user\")),\n\t\tUUID: didit.String(\"5b9a0000-0000-4000-8000-00000000f00d\"),\n\t}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import java.util.List; import me.didit.Didit; import me.didit.types.CasesCreateParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.cases().create(CasesCreateParams.builder() .title("Manual - Jane Doe") .blueprint("b1de0000-0000-4000-8000-000000000002") .priority(CasesCreateParams.Priority.of("HIGH")) .tags(List.of("review")) .subject(CasesCreateParams.Subject.builder() .type(CasesCreateParams.Subject.Type.of("user")) .uuid("5b9a0000-0000-4000-8000-00000000f00d") .build()) .build()); System.out.println(result); - lang: php label: PHP source: |- cases->create([ 'title' => 'Manual - Jane Doe', 'blueprint' => 'b1de0000-0000-4000-8000-000000000002', 'priority' => 'HIGH', 'tags' => ['review'], 'subject' => [ 'type' => 'user', 'uuid' => '5b9a0000-0000-4000-8000-00000000f00d', ], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.cases.create( title: "Manual - Jane Doe", blueprint: "b1de0000-0000-4000-8000-000000000002", priority: "HIGH", tags: ["review"], subject: { type: "user", uuid: "5b9a0000-0000-4000-8000-00000000f00d", } ) puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Cases.CreateAsync(new CasesCreateParams { Title = "Manual - Jane Doe", Blueprint = "b1de0000-0000-4000-8000-000000000002", Priority = new CasesCreateParamsPriority("HIGH"), Tags = new string[] { "review" }, Subject = new CasesCreateParamsSubject { Type = new CasesCreateParamsSubjectType("user"), Uuid = "5b9a0000-0000-4000-8000-00000000f00d", }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: CaseDuplicateCaseFraudSourceContextRequest: type: object properties: check_id: type: string format: uuid request_id: type: string format: uuid source_section: type: string minLength: 1 pattern: ^[A-Z][A-Z0-9_:-]{0,63}$ required: - check_id - request_id - source_section CaseDetail: type: object properties: uuid: type: string format: uuid case_number: type: string nullable: true title: type: string status: type: string enum: - OPEN - AWAITING_USER - RESOLVED resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED nullable: true resolution_notes: type: string nullable: true priority: type: string enum: - LOW - MEDIUM - HIGH source: type: string enum: - MANUAL - AML_SCREENING - TRANSACTION_RULE - WORKFLOW_BUILDER tags: type: array items: type: string subject: $ref: '#/components/schemas/CaseSubject' assigned_to: $ref: '#/components/schemas/CaseAssignee' assigned_at: type: string format: date-time nullable: true team: $ref: '#/components/schemas/CaseTeamSummary' due_at: type: string format: date-time nullable: true resolved_at: type: string format: date-time nullable: true resolved_by_email: type: string nullable: true pending_resolution: type: object nullable: true description: 4眼原則による解決がチェッカーのブループリント上で保留され、承認または承認の却下を待っている間のみ設定されます。 properties: resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED resolution_notes: type: string nullable: true maker_email: type: string format: email nullable: true description: >- 解決内容を提出した担当者のメールアドレス。APIキーで提出された場合はnullです。その解決内容には作成者が記録されないため、approveおよびreject-approvalはすべての呼び出し元に対して403を返します。 maker_name: type: string nullable: true maker_user_id: type: string format: uuid nullable: true description: >- 解決を送信した担当者のメンバーユーザーUUIDです。APIキーで送信された場合はnullです。そのメンバーを`checker`として指定することはできません。 maker_blueprint_id: type: string format: uuid staged_at: type: string format: date-time checker: $ref: '#/components/schemas/CaseChecker' metadata: type: object blueprint: $ref: '#/components/schemas/CaseBlueprintDetail' notes: type: array items: $ref: '#/components/schemas/CaseNote' description: 最新の50件のメモ。 events: type: array items: $ref: '#/components/schemas/CaseEvent' description: 最新の100件のイベント。 links: type: array items: $ref: '#/components/schemas/CaseLink' links_count: type: integer notes_count: type: integer checklist_items: type: array items: $ref: '#/components/schemas/CaseChecklistItem' created_at: type: string format: date-time updated_at: type: string format: date-time CaseSubject: type: object nullable: true description: ケースが紐づく単一のユーザーまたは企業。 properties: type: type: string enum: - user - business uuid: type: string format: uuid name: type: string external_id: type: string nullable: true description: 対象のvendor_data。 country: type: string nullable: true description: >- 対象者の3文字の国コード(ISO 3166-1 alpha-3)。不明な場合はnullです。企業の場合は設立国です。個人の場合は、認証で提出された本人確認書類の発行国です。複数の国の書類を持つ個人の場合はそのうち1つが表示され、`XXA`などのICAO書類コードが表示されることもあります。 example: ESP portrait: type: string format: uri nullable: true description: >- 人物の顔写真画像への有効期間の短い署名付きURL。企業の場合は常にnullで、顔写真のない人物の場合もnullです。URLには有効期限があるため、URLを保存するのではなく、ケースを読み取る際に画像をダウンロードしてください。 CaseAssignee: type: object nullable: true properties: uuid: type: string format: uuid full_name: type: string email: type: string format: email CaseTeamSummary: type: object nullable: true description: >- ケースを担当するレビューチームです。担当チームがない場合はnullです。ルーティングルールによってケースがいずれかのチームに割り当てられると、ルーティングにより設定されます。`PATCH .../cases/{case_uuid}/`（`team`）で変更またはクリアできます。 properties: uuid: type: string format: uuid name: type: string CaseChecker: type: object nullable: true description: >- 保留中の解決を承認または却下するよう指名されたメンバーです。二者承認(four-eyes)方式の解決が指名されたチェッカーを待っている間のみ設定されます。保留中のものがない場合、保留中の解決がチェッカーキューで待機している間、および解決が承認、却下された後や、証拠が変更されたために新たなレビューに差し戻された後はnullです。 properties: member_uuid: type: string format: uuid description: メンバーのユーザーuuidです。ケースを解決する際に`checker`として渡す値です。 name: type: string nullable: true description: メンバーの氏名です。不明な場合はnullです。 email: type: string format: email CaseBlueprintDetail: type: object properties: uuid: type: string format: uuid name: type: string maxLength: 24 description: type: string nullable: true assignment_method: type: string enum: - MANUAL - AUTOMATIC assignee_pool: type: array items: type: string format: uuid max_active_cases: type: integer nullable: true escalation_enabled: type: boolean transfer_enabled: type: boolean require_resolution_note: type: boolean is_active: type: boolean preset_key: type: string nullable: true created_at: type: string format: date-time escalation_blueprint: type: string format: uuid nullable: true escalation_blueprint_name: type: string nullable: true four_eyes_checker_blueprint: type: string format: uuid nullable: true four_eyes_checker_blueprint_name: type: string nullable: true content_config: type: object description: ケースページに表示されるタブとフィールドを決定する、切り替え可能な6つのセクション。不明なセクションやキーは拒否されます。 properties: checklist: type: object properties: enabled: type: boolean optional: type: boolean description: trueの場合、チェックリストに未完了の項目があってもケースを解決できます。 items: type: array items: type: object properties: label: type: string maxLength: 255 order: type: integer aml_control: type: object properties: enabled: type: boolean financial: type: boolean identity: type: boolean identity: type: object properties: enabled: type: boolean personal_information: type: boolean applicant_tags: type: boolean contact_information: type: boolean risk_overview: type: boolean poi_documents: type: boolean poa_documents: type: boolean verifications: type: object properties: enabled: type: boolean summary: type: boolean reporting: type: object properties: enabled: type: boolean fiu_reports: type: boolean financial: type: object properties: enabled: type: boolean payment_methods: type: boolean transactions: type: boolean creation_sources: type: array description: 現在、新しいケースをこのブループリントに振り分けているコネクター。 items: type: object properties: kind: type: string enum: - aml - rule - workflow id: type: string name: type: string receives_escalation_from: type: array description: エスカレーション先としてこのブループリントを指定している他のブループリントです。 items: type: object properties: id: type: string name: type: string updated_at: type: string format: date-time version: type: integer readOnly: true default_deadline_hours: type: integer nullable: true minimum: 1 maximum: 8760 CaseNote: type: object properties: uuid: type: string format: uuid comment: type: string actor_email: type: string format: email nullable: true actor_name: type: string nullable: true mentioned_emails: type: array items: type: string format: email is_internal: type: boolean attachments: type: array items: type: object properties: s3_key: type: string filename: type: string file_size: type: integer url: type: string format: uri tags: type: array items: type: string created_at: type: string format: date-time CaseEvent: type: object properties: uuid: type: string format: uuid event_type: type: string enum: - CREATED - STATUS_CHANGED - ASSIGNED - UNASSIGNED - RESOLVED - REOPENED - LINK_ADDED - LINK_REMOVED - NOTE_ADDED - NOTE_PINNED - NOTE_UNPINNED - PRIORITY_CHANGED - DUE_DATE_CHANGED - TAG_ADDED - TAG_REMOVED - ESCALATED - TRANSFERRED - CHECKLIST_COMPLETED - REPORT_CREATED - REPORT_FINALIZED - SUBMITTED_FOR_APPROVAL - APPROVAL_GRANTED - APPROVAL_REJECTED - ENTITY_ACTION - APPROVAL_INVALIDATED - CUSTOMER_REQUEST - STAGE_CHANGED - TEAM_CHANGED - CHECKER_ASSIGNED - CHECKER_UNASSIGNED actor_email: type: string format: email nullable: true actor_name: type: string nullable: true previous_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true new_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true metadata: type: object created_at: type: string format: date-time CaseLink: type: object properties: uuid: type: string format: uuid linked_entity_type: type: string enum: - session - business_session - transaction nullable: true linked_entity_uuid: type: string format: uuid nullable: true linked_entity_summary: type: object nullable: true description: >- sessionおよびbusiness_sessionのリンクではsession_id/session_number/status、transactionのリンクではuuid/txn_id/statusです。 created_at: type: string format: date-time CaseChecklistItem: type: object properties: uuid: type: string format: uuid label: type: string maxLength: 255 is_completed: type: boolean completed_by: type: string format: email nullable: true completed_at: type: string format: date-time nullable: true order: type: integer 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.