Get Started
Integrate / SDKs
User Verification
Business Verification
Transaction Monitoring
Changelogcurl
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"]}'import os
import requests
resp = requests.post(
'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/',
headers={'x-api-key': os.environ['DIDIT_API_KEY']},
json={
'title': 'Manual - Jane Doe',
'blueprint': 'b1de0000-0000-4000-8000-000000000002',
'priority': 'HIGH',
'subject': {'type': 'user', 'uuid': '5b9a0000-0000-4000-8000-00000000f00d'},
},
timeout=10,
)
resp.raise_for_status()
case = resp.json()
print(case['case_number'], case['uuid'])const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
blueprint: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
priority: 'MEDIUM',
due_at: '2023-11-07T05:31:56Z',
tags: ['<string>'],
subject: {uuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
links: [{}],
assigned_to: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
review_duplicates: false,
separate_incident_reason: '<string>'
})
};
fetch('https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'blueprint' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'priority' => 'MEDIUM',
'due_at' => '2023-11-07T05:31:56Z',
'tags' => [
'<string>'
],
'subject' => [
'uuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'links' => [
[
]
],
'assigned_to' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'review_duplicates' => false,
'separate_incident_reason' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"blueprint\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"MEDIUM\",\n \"due_at\": \"2023-11-07T05:31:56Z\",\n \"tags\": [\n \"<string>\"\n ],\n \"subject\": {\n \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"links\": [\n {}\n ],\n \"assigned_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"review_duplicates\": false,\n \"separate_incident_reason\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"blueprint\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"MEDIUM\",\n \"due_at\": \"2023-11-07T05:31:56Z\",\n \"tags\": [\n \"<string>\"\n ],\n \"subject\": {\n \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"links\": [\n {}\n ],\n \"assigned_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"review_duplicates\": false,\n \"separate_incident_reason\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"blueprint\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"MEDIUM\",\n \"due_at\": \"2023-11-07T05:31:56Z\",\n \"tags\": [\n \"<string>\"\n ],\n \"subject\": {\n \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"links\": [\n {}\n ],\n \"assigned_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"review_duplicates\": false,\n \"separate_incident_reason\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"case_number": "<string>",
"title": "<string>",
"status": "OPEN",
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"priority": "LOW",
"source": "MANUAL",
"tags": [
"<string>"
],
"subject": {
"type": "user",
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"external_id": "<string>"
},
"assigned_to": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "jsmith@example.com"
},
"assigned_at": "2023-11-07T05:31:56Z",
"due_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by_email": "<string>",
"pending_resolution": {
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"maker_email": "jsmith@example.com",
"maker_name": "<string>",
"maker_blueprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"staged_at": "2023-11-07T05:31:56Z"
},
"metadata": {},
"blueprint": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"assignment_method": "MANUAL",
"assignee_pool": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"max_active_cases": 123,
"escalation_enabled": true,
"transfer_enabled": true,
"require_resolution_note": true,
"is_active": true,
"preset_key": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"escalation_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"escalation_blueprint_name": "<string>",
"four_eyes_checker_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"four_eyes_checker_blueprint_name": "<string>",
"content_config": {
"checklist": {
"enabled": true,
"optional": true,
"items": [
{
"label": "<string>",
"order": 123
}
]
},
"aml_control": {
"enabled": true,
"financial": true,
"identity": true
},
"identity": {
"enabled": true,
"personal_information": true,
"applicant_tags": true,
"contact_information": true,
"risk_overview": true,
"poi_documents": true,
"poa_documents": true
},
"verifications": {
"enabled": true,
"summary": true
},
"reporting": {
"enabled": true,
"fiu_reports": true
},
"financial": {
"enabled": true,
"payment_methods": true,
"transactions": true
}
},
"creation_sources": [
{
"kind": "aml",
"id": "<string>",
"name": "<string>"
}
],
"receives_escalation_from": [
{
"id": "<string>",
"name": "<string>"
}
],
"updated_at": "2023-11-07T05:31:56Z",
"version": 123,
"default_deadline_hours": 4380
},
"notes": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"comment": "<string>",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"mentioned_emails": [
"jsmith@example.com"
],
"is_internal": true,
"attachments": [
{
"s3_key": "<string>",
"filename": "<string>",
"file_size": 123,
"url": "<string>"
}
],
"tags": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"events": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "CREATED",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"previous_status": "OPEN",
"new_status": "OPEN",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_type": "session",
"linked_entity_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_summary": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links_count": 123,
"notes_count": 123,
"checklist_items": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "<string>",
"is_completed": true,
"completed_by": "jsmith@example.com",
"completed_at": "2023-11-07T05:31:56Z",
"order": 123
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{}Cases
Create Case
Create a case anchored to exactly one subject (a user or a business), directly or by deriving the subject from an attached session/transaction link. Source is always MANUAL for API-created cases.
POST
/
v3
/
organization
/
{organization_id}
/
application
/
{application_id}
/
cases
/
curl
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"]}'import os
import requests
resp = requests.post(
'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/',
headers={'x-api-key': os.environ['DIDIT_API_KEY']},
json={
'title': 'Manual - Jane Doe',
'blueprint': 'b1de0000-0000-4000-8000-000000000002',
'priority': 'HIGH',
'subject': {'type': 'user', 'uuid': '5b9a0000-0000-4000-8000-00000000f00d'},
},
timeout=10,
)
resp.raise_for_status()
case = resp.json()
print(case['case_number'], case['uuid'])const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
blueprint: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
priority: 'MEDIUM',
due_at: '2023-11-07T05:31:56Z',
tags: ['<string>'],
subject: {uuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
links: [{}],
assigned_to: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
review_duplicates: false,
separate_incident_reason: '<string>'
})
};
fetch('https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'blueprint' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'priority' => 'MEDIUM',
'due_at' => '2023-11-07T05:31:56Z',
'tags' => [
'<string>'
],
'subject' => [
'uuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'links' => [
[
]
],
'assigned_to' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'review_duplicates' => false,
'separate_incident_reason' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"blueprint\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"MEDIUM\",\n \"due_at\": \"2023-11-07T05:31:56Z\",\n \"tags\": [\n \"<string>\"\n ],\n \"subject\": {\n \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"links\": [\n {}\n ],\n \"assigned_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"review_duplicates\": false,\n \"separate_incident_reason\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"blueprint\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"MEDIUM\",\n \"due_at\": \"2023-11-07T05:31:56Z\",\n \"tags\": [\n \"<string>\"\n ],\n \"subject\": {\n \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"links\": [\n {}\n ],\n \"assigned_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"review_duplicates\": false,\n \"separate_incident_reason\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"blueprint\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"MEDIUM\",\n \"due_at\": \"2023-11-07T05:31:56Z\",\n \"tags\": [\n \"<string>\"\n ],\n \"subject\": {\n \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"links\": [\n {}\n ],\n \"assigned_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"review_duplicates\": false,\n \"separate_incident_reason\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"case_number": "<string>",
"title": "<string>",
"status": "OPEN",
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"priority": "LOW",
"source": "MANUAL",
"tags": [
"<string>"
],
"subject": {
"type": "user",
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"external_id": "<string>"
},
"assigned_to": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "jsmith@example.com"
},
"assigned_at": "2023-11-07T05:31:56Z",
"due_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by_email": "<string>",
"pending_resolution": {
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"maker_email": "jsmith@example.com",
"maker_name": "<string>",
"maker_blueprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"staged_at": "2023-11-07T05:31:56Z"
},
"metadata": {},
"blueprint": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"assignment_method": "MANUAL",
"assignee_pool": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"max_active_cases": 123,
"escalation_enabled": true,
"transfer_enabled": true,
"require_resolution_note": true,
"is_active": true,
"preset_key": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"escalation_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"escalation_blueprint_name": "<string>",
"four_eyes_checker_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"four_eyes_checker_blueprint_name": "<string>",
"content_config": {
"checklist": {
"enabled": true,
"optional": true,
"items": [
{
"label": "<string>",
"order": 123
}
]
},
"aml_control": {
"enabled": true,
"financial": true,
"identity": true
},
"identity": {
"enabled": true,
"personal_information": true,
"applicant_tags": true,
"contact_information": true,
"risk_overview": true,
"poi_documents": true,
"poa_documents": true
},
"verifications": {
"enabled": true,
"summary": true
},
"reporting": {
"enabled": true,
"fiu_reports": true
},
"financial": {
"enabled": true,
"payment_methods": true,
"transactions": true
}
},
"creation_sources": [
{
"kind": "aml",
"id": "<string>",
"name": "<string>"
}
],
"receives_escalation_from": [
{
"id": "<string>",
"name": "<string>"
}
],
"updated_at": "2023-11-07T05:31:56Z",
"version": 123,
"default_deadline_hours": 4380
},
"notes": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"comment": "<string>",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"mentioned_emails": [
"jsmith@example.com"
],
"is_internal": true,
"attachments": [
{
"s3_key": "<string>",
"filename": "<string>",
"file_size": 123,
"url": "<string>"
}
],
"tags": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"events": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "CREATED",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"previous_status": "OPEN",
"new_status": "OPEN",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_type": "session",
"linked_entity_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_summary": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links_count": 123,
"notes_count": 123,
"checklist_items": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "<string>",
"is_completed": true,
"completed_by": "jsmith@example.com",
"completed_at": "2023-11-07T05:31:56Z",
"order": 123
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{}
Create a case anchored to exactly one subject. Provide
subject directly, or supply links and let Didit derive the subject from the first linked entity’s owner.
Pass
blueprint whenever you have one - it determines which case-page sections render, whether resolution requires a note, and where the case routes on escalation or transfer.Related
Authorizations
Path Parameters
Organization UUID.
Application UUID.
Body
application/json
Maximum string length:
255CaseBlueprint UUID. Omit for no blueprint.
Available options:
LOW, MEDIUM, HIGH Required unless links is provided; the case's exactly-one subject.
Show child attributes
Show child attributes
Sessions/business sessions/transactions to attach on creation, e.g. [{"entity_type": "transaction", "entity_uuid": "..."}]. When subject is omitted, the subject is derived from the first link's owner.
User UUID to assign immediately.
Recheck existing investigations before creating the case. When true, a subject with existing cases requires a nonblank separate_incident_reason. The console always enables this protection. Omitting it preserves existing API behavior.
Maximum string length:
1000Show child attributes
Show child attributes
Response
Case created.
Available options:
OPEN, AWAITING_USER, RESOLVED Available options:
FALSE_POSITIVE, VALID_THREAT Available options:
LOW, MEDIUM, HIGH Available options:
MANUAL, AML_SCREENING, TRANSACTION_RULE, WORKFLOW_BUILDER The single user or business the case is anchored to.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Set only while a 4-eyes resolution is staged on the checker blueprint, awaiting approve or reject-approval.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Newest 50 notes.
Show child attributes
Show child attributes
Newest 100 events.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes