Get Started
Integrate / SDKs
User Verification
Business Verification
Transaction Monitoring
Changelogcurl
curl -X POST 'https://verification.didit.me/v3/events/batch/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"events": [
{"event_id": "login-2026-10-17-000001", "event_category": "auth", "action_type": "login",
"occurred_at": "2026-10-17T09:15:02.481Z", "subject": {"vendor_data": "user-42"}},
{"event_id": "deposit-2026-10-17-000002", "event_category": "payment", "action_type": "deposit_completed",
"occurred_at": "2026-10-17T09:16:40.000Z", "subject": {"vendor_data": "user-42"},
"transaction_context": {"amount": "100.00", "currency": "EUR", "payment_reference_id": "dep_736"},
"payload": {"payment_method": "card", "status": "completed"}}
]
}'import os
import requests
events = [
{
'event_id': 'login-2026-10-17-000001',
'event_category': 'auth',
'action_type': 'login',
'occurred_at': '2026-10-17T09:15:02.481Z',
'subject': {'vendor_data': 'user-42'},
},
{
'event_id': 'deposit-2026-10-17-000002',
'event_category': 'payment',
'action_type': 'deposit_completed',
'occurred_at': '2026-10-17T09:16:40.000Z',
'subject': {'vendor_data': 'user-42'},
'transaction_context': {'amount': '100.00', 'currency': 'EUR', 'payment_reference_id': 'dep_736'},
'payload': {'payment_method': 'card', 'status': 'completed'},
},
]
resp = requests.post(
'https://verification.didit.me/v3/events/batch/',
headers={'x-api-key': os.environ['DIDIT_API_KEY']},
json={'events': events},
timeout=10,
)
resp.raise_for_status() # 201 and 207 are both success
batch = resp.json()
for item in batch['results']:
if item['outcome'] == 'rejected':
print('fix and resend', events[item['index']]['event_id'], item['errors'])const events = [
{
event_id: 'login-2026-10-17-000001',
event_category: 'auth',
action_type: 'login',
occurred_at: '2026-10-17T09:15:02.481Z',
subject: { vendor_data: 'user-42' },
},
{
event_id: 'deposit-2026-10-17-000002',
event_category: 'payment',
action_type: 'deposit_completed',
occurred_at: '2026-10-17T09:16:40.000Z',
subject: { vendor_data: 'user-42' },
transaction_context: { amount: '100.00', currency: 'EUR', payment_reference_id: 'dep_736' },
payload: { payment_method: 'card', status: 'completed' },
},
];
const resp = await fetch('https://verification.didit.me/v3/events/batch/', {
method: 'POST',
headers: {
'x-api-key': process.env.DIDIT_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({ events }),
});
if (!resp.ok) throw new Error(await resp.text()); // 201 and 207 are both ok
const batch = await resp.json();
for (const item of batch.results) {
if (item.outcome === 'rejected') console.log('fix and resend', events[item.index].event_id, item.errors);
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/events/batch/",
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([
'events' => [
[
'event_id' => 'login-2026-10-17-000001',
'event_category' => 'auth',
'action_type' => 'login',
'occurred_at' => '2026-10-17T09:15:02.481Z',
'subject' => [
'vendor_data' => 'user-42'
]
],
[
'event_id' => 'deposit-2026-10-17-000002',
'event_category' => 'payment',
'action_type' => 'deposit_completed',
'occurred_at' => '2026-10-17T09:16:40Z',
'subject' => [
'vendor_data' => 'user-42'
],
'transaction_context' => [
'amount' => '100.00',
'currency' => 'EUR',
'payment_reference_id' => 'dep_736'
],
'payload' => [
'payment_method' => 'card',
'status' => 'completed'
]
]
]
]),
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/events/batch/"
payload := strings.NewReader("{\n \"events\": [\n {\n \"event_id\": \"login-2026-10-17-000001\",\n \"event_category\": \"auth\",\n \"action_type\": \"login\",\n \"occurred_at\": \"2026-10-17T09:15:02.481Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n }\n },\n {\n \"event_id\": \"deposit-2026-10-17-000002\",\n \"event_category\": \"payment\",\n \"action_type\": \"deposit_completed\",\n \"occurred_at\": \"2026-10-17T09:16:40Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n },\n \"transaction_context\": {\n \"amount\": \"100.00\",\n \"currency\": \"EUR\",\n \"payment_reference_id\": \"dep_736\"\n },\n \"payload\": {\n \"payment_method\": \"card\",\n \"status\": \"completed\"\n }\n }\n ]\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/events/batch/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"events\": [\n {\n \"event_id\": \"login-2026-10-17-000001\",\n \"event_category\": \"auth\",\n \"action_type\": \"login\",\n \"occurred_at\": \"2026-10-17T09:15:02.481Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n }\n },\n {\n \"event_id\": \"deposit-2026-10-17-000002\",\n \"event_category\": \"payment\",\n \"action_type\": \"deposit_completed\",\n \"occurred_at\": \"2026-10-17T09:16:40Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n },\n \"transaction_context\": {\n \"amount\": \"100.00\",\n \"currency\": \"EUR\",\n \"payment_reference_id\": \"dep_736\"\n },\n \"payload\": {\n \"payment_method\": \"card\",\n \"status\": \"completed\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/events/batch/")
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 \"events\": [\n {\n \"event_id\": \"login-2026-10-17-000001\",\n \"event_category\": \"auth\",\n \"action_type\": \"login\",\n \"occurred_at\": \"2026-10-17T09:15:02.481Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n }\n },\n {\n \"event_id\": \"deposit-2026-10-17-000002\",\n \"event_category\": \"payment\",\n \"action_type\": \"deposit_completed\",\n \"occurred_at\": \"2026-10-17T09:16:40Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n },\n \"transaction_context\": {\n \"amount\": \"100.00\",\n \"currency\": \"EUR\",\n \"payment_reference_id\": \"dep_736\"\n },\n \"payload\": {\n \"payment_method\": \"card\",\n \"status\": \"completed\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"accepted_count": 1,
"replayed_count": 1,
"rejected_count": 0,
"results": [
{
"index": 0,
"outcome": "accepted",
"event_uuid": "33333333-4444-5555-6666-777777777777",
"event_id": "login-2026-10-17-000001",
"status": "ACCEPTED",
"score": 0,
"rules_evaluated_count": 6,
"rules_matched_count": 0,
"correlation_pending": false,
"retention_class": "standard",
"expires_at": "2026-11-16T09:15:02.481000Z",
"idempotent_replay": false,
"rule_matches": []
},
{
"index": 1,
"outcome": "replayed",
"event_uuid": "11111111-2222-3333-4444-555555555555",
"event_id": "deposit-2026-10-17-000002",
"status": "ACCEPTED",
"score": 0,
"rules_evaluated_count": 6,
"rules_matched_count": 0,
"correlation_pending": false,
"retention_class": "monetary_or_compliance",
"expires_at": null,
"idempotent_replay": true,
"rule_matches": []
}
]
}Monitoring Events
Create Monitoring Events in Batch
Submit up to 500 monitoring events in one request with a per-item outcome, so one malformed event never blocks the rest of the batch.
POST
/
v3
/
events
/
batch
/
curl
curl -X POST 'https://verification.didit.me/v3/events/batch/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"events": [
{"event_id": "login-2026-10-17-000001", "event_category": "auth", "action_type": "login",
"occurred_at": "2026-10-17T09:15:02.481Z", "subject": {"vendor_data": "user-42"}},
{"event_id": "deposit-2026-10-17-000002", "event_category": "payment", "action_type": "deposit_completed",
"occurred_at": "2026-10-17T09:16:40.000Z", "subject": {"vendor_data": "user-42"},
"transaction_context": {"amount": "100.00", "currency": "EUR", "payment_reference_id": "dep_736"},
"payload": {"payment_method": "card", "status": "completed"}}
]
}'import os
import requests
events = [
{
'event_id': 'login-2026-10-17-000001',
'event_category': 'auth',
'action_type': 'login',
'occurred_at': '2026-10-17T09:15:02.481Z',
'subject': {'vendor_data': 'user-42'},
},
{
'event_id': 'deposit-2026-10-17-000002',
'event_category': 'payment',
'action_type': 'deposit_completed',
'occurred_at': '2026-10-17T09:16:40.000Z',
'subject': {'vendor_data': 'user-42'},
'transaction_context': {'amount': '100.00', 'currency': 'EUR', 'payment_reference_id': 'dep_736'},
'payload': {'payment_method': 'card', 'status': 'completed'},
},
]
resp = requests.post(
'https://verification.didit.me/v3/events/batch/',
headers={'x-api-key': os.environ['DIDIT_API_KEY']},
json={'events': events},
timeout=10,
)
resp.raise_for_status() # 201 and 207 are both success
batch = resp.json()
for item in batch['results']:
if item['outcome'] == 'rejected':
print('fix and resend', events[item['index']]['event_id'], item['errors'])const events = [
{
event_id: 'login-2026-10-17-000001',
event_category: 'auth',
action_type: 'login',
occurred_at: '2026-10-17T09:15:02.481Z',
subject: { vendor_data: 'user-42' },
},
{
event_id: 'deposit-2026-10-17-000002',
event_category: 'payment',
action_type: 'deposit_completed',
occurred_at: '2026-10-17T09:16:40.000Z',
subject: { vendor_data: 'user-42' },
transaction_context: { amount: '100.00', currency: 'EUR', payment_reference_id: 'dep_736' },
payload: { payment_method: 'card', status: 'completed' },
},
];
const resp = await fetch('https://verification.didit.me/v3/events/batch/', {
method: 'POST',
headers: {
'x-api-key': process.env.DIDIT_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({ events }),
});
if (!resp.ok) throw new Error(await resp.text()); // 201 and 207 are both ok
const batch = await resp.json();
for (const item of batch.results) {
if (item.outcome === 'rejected') console.log('fix and resend', events[item.index].event_id, item.errors);
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/events/batch/",
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([
'events' => [
[
'event_id' => 'login-2026-10-17-000001',
'event_category' => 'auth',
'action_type' => 'login',
'occurred_at' => '2026-10-17T09:15:02.481Z',
'subject' => [
'vendor_data' => 'user-42'
]
],
[
'event_id' => 'deposit-2026-10-17-000002',
'event_category' => 'payment',
'action_type' => 'deposit_completed',
'occurred_at' => '2026-10-17T09:16:40Z',
'subject' => [
'vendor_data' => 'user-42'
],
'transaction_context' => [
'amount' => '100.00',
'currency' => 'EUR',
'payment_reference_id' => 'dep_736'
],
'payload' => [
'payment_method' => 'card',
'status' => 'completed'
]
]
]
]),
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/events/batch/"
payload := strings.NewReader("{\n \"events\": [\n {\n \"event_id\": \"login-2026-10-17-000001\",\n \"event_category\": \"auth\",\n \"action_type\": \"login\",\n \"occurred_at\": \"2026-10-17T09:15:02.481Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n }\n },\n {\n \"event_id\": \"deposit-2026-10-17-000002\",\n \"event_category\": \"payment\",\n \"action_type\": \"deposit_completed\",\n \"occurred_at\": \"2026-10-17T09:16:40Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n },\n \"transaction_context\": {\n \"amount\": \"100.00\",\n \"currency\": \"EUR\",\n \"payment_reference_id\": \"dep_736\"\n },\n \"payload\": {\n \"payment_method\": \"card\",\n \"status\": \"completed\"\n }\n }\n ]\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/events/batch/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"events\": [\n {\n \"event_id\": \"login-2026-10-17-000001\",\n \"event_category\": \"auth\",\n \"action_type\": \"login\",\n \"occurred_at\": \"2026-10-17T09:15:02.481Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n }\n },\n {\n \"event_id\": \"deposit-2026-10-17-000002\",\n \"event_category\": \"payment\",\n \"action_type\": \"deposit_completed\",\n \"occurred_at\": \"2026-10-17T09:16:40Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n },\n \"transaction_context\": {\n \"amount\": \"100.00\",\n \"currency\": \"EUR\",\n \"payment_reference_id\": \"dep_736\"\n },\n \"payload\": {\n \"payment_method\": \"card\",\n \"status\": \"completed\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/events/batch/")
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 \"events\": [\n {\n \"event_id\": \"login-2026-10-17-000001\",\n \"event_category\": \"auth\",\n \"action_type\": \"login\",\n \"occurred_at\": \"2026-10-17T09:15:02.481Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n }\n },\n {\n \"event_id\": \"deposit-2026-10-17-000002\",\n \"event_category\": \"payment\",\n \"action_type\": \"deposit_completed\",\n \"occurred_at\": \"2026-10-17T09:16:40Z\",\n \"subject\": {\n \"vendor_data\": \"user-42\"\n },\n \"transaction_context\": {\n \"amount\": \"100.00\",\n \"currency\": \"EUR\",\n \"payment_reference_id\": \"dep_736\"\n },\n \"payload\": {\n \"payment_method\": \"card\",\n \"status\": \"completed\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"accepted_count": 1,
"replayed_count": 1,
"rejected_count": 0,
"results": [
{
"index": 0,
"outcome": "accepted",
"event_uuid": "33333333-4444-5555-6666-777777777777",
"event_id": "login-2026-10-17-000001",
"status": "ACCEPTED",
"score": 0,
"rules_evaluated_count": 6,
"rules_matched_count": 0,
"correlation_pending": false,
"retention_class": "standard",
"expires_at": "2026-11-16T09:15:02.481000Z",
"idempotent_replay": false,
"rule_matches": []
},
{
"index": 1,
"outcome": "replayed",
"event_uuid": "11111111-2222-3333-4444-555555555555",
"event_id": "deposit-2026-10-17-000002",
"status": "ACCEPTED",
"score": 0,
"rules_evaluated_count": 6,
"rules_matched_count": 0,
"correlation_pending": false,
"retention_class": "monetary_or_compliance",
"expires_at": null,
"idempotent_replay": true,
"rule_matches": []
}
]
}
See Batches in the event ingestion guide. The device lane has the same per-item outcomes for SDK flushes: see SDK event submission.
Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Body
application/json
1 to 500 events. Each item follows MonitoringEventCreateRequest, including the 7-day past and 5-minute future window on occurred_at.
Required array length:
1 - 500 elementsShow child attributes
Show child attributes
Response
No item was rejected: every item is accepted or replayed.
Items stored and evaluated.
Required range:
x >= 0Items already stored with the same content.
Required range:
x >= 0Items not stored.
Required range:
x >= 0One entry per item, in request order.
Show child attributes
Show child attributes