curl -X POST 'https://verification.didit.me/v3/events/' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "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", "entity_type": "individual"},
    "session": {"session_id": "web-session-abc", "sequence": 142},
    "device_context": {
      "fingerprint": "fp-a8c1",
      "network_context": {"ip_address": "203.0.113.42"}
    },
    "payload": {"method": "password"}
  }'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.monitoring_events.create(
    event_id="login-2026-10-17-000001",
    event_category="auth",
    action_type="login",
    occurred_at="2026-10-17T09:15:02.481Z",
    time_zone="Europe/Madrid",
    subject={
        "vendor_data": "user-42",
        "entity_type": "individual",
    },
    session={
        "session_id": "web-session-abc",
        "sequence": 142,
    },
    device_context={
        "fingerprint": "fp-a8c1",
        "network_context": {
            "ip_address": "203.0.113.42",
        },
    },
    payload={"method": "password"},
    custom_values={"vip_tier": "gold"},
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.monitoringEvents.create({
  event_id: "login-2026-10-17-000001",
  event_category: "auth",
  action_type: "login",
  occurred_at: "2026-10-17T09:15:02.481Z",
  time_zone: "Europe/Madrid",
  subject: {
    vendor_data: "user-42",
    entity_type: "individual",
  },
  session: {
    session_id: "web-session-abc",
    sequence: 142,
  },
  device_context: {
    fingerprint: "fp-a8c1",
    network_context: {
      ip_address: "203.0.113.42",
    },
  },
  payload: { method: "password" },
  custom_values: { vip_tier: "gold" },
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.MonitoringEvents.Create(ctx, didit.MonitoringEventCreateRequest{
	EventID:       "login-2026-10-17-000001",
	EventCategory: "auth",
	ActionType:    "login",
	OccurredAt:    time.Date(2026, 10, 17, 9, 15, 2, 0, time.UTC),
	TimeZone:      didit.String("Europe/Madrid"),
	Subject: didit.MonitoringEventCreateRequestSubject{
		VendorData: "user-42",
		EntityType: didit.String("individual"),
	},
	Session: didit.Some(didit.MonitoringEventCreateRequestSession{
		SessionID: didit.String("web-session-abc"),
		Sequence:  didit.Int(142),
	}),
	DeviceContext: didit.Some(didit.MonitoringEventCreateRequestDeviceContext{
		Fingerprint: didit.String("fp-a8c1"),
		NetworkContext: didit.Some(didit.MonitoringEventCreateRequestDeviceContextNetworkContext{
			IPAddress: didit.String("203.0.113.42"),
		}),
	}),
	Payload:      didit.Some(map[string]any{"method": "password"}),
	CustomValues: didit.Some(map[string]any{"vip_tier": "gold"}),
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import java.time.OffsetDateTime;
import java.util.Map;
import me.didit.Didit;
import me.didit.types.MonitoringEventCreateRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.monitoringEvents().create(MonitoringEventCreateRequest.builder()
        .eventId("login-2026-10-17-000001")
        .eventCategory(MonitoringEventCreateRequest.EventCategory.of("auth"))
        .actionType("login")
        .occurredAt(OffsetDateTime.parse("2026-10-17T09:15:02.481Z"))
        .timeZone("Europe/Madrid")
        .subject(MonitoringEventCreateRequest.Subject.builder()
                .vendorData("user-42")
                .entityType("individual")
                .build())
        .session(MonitoringEventCreateRequest.Session.builder()
                .sessionId("web-session-abc")
                .sequence(142L)
                .build())
        .deviceContext(MonitoringEventCreateRequest.DeviceContext.builder()
                .fingerprint("fp-a8c1")
                .networkContext(MonitoringEventCreateRequest.DeviceContext.NetworkContext.builder()
                        .ipAddress("203.0.113.42")
                        .build())
                .build())
        .payload(Map.of("method", "password"))
        .customValues(Map.of("vip_tier", MonitoringEventCreateRequest.CustomValuesValue.ofString("gold")))
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->monitoringEvents->create([
    'event_id' => 'login-2026-10-17-000001',
    'event_category' => 'auth',
    'action_type' => 'login',
    'occurred_at' => '2026-10-17T09:15:02.481Z',
    'time_zone' => 'Europe/Madrid',
    'subject' => [
        'vendor_data' => 'user-42',
        'entity_type' => 'individual',
    ],
    'session' => [
        'session_id' => 'web-session-abc',
        'sequence' => 142,
    ],
    'device_context' => [
        'fingerprint' => 'fp-a8c1',
        'network_context' => [
            'ip_address' => '203.0.113.42',
        ],
    ],
    'payload' => ['method' => 'password'],
    'custom_values' => ['vip_tier' => 'gold'],
]);
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.monitoring_events.create(
  event_id: "login-2026-10-17-000001",
  event_category: "auth",
  action_type: "login",
  occurred_at: "2026-10-17T09:15:02.481Z",
  time_zone: "Europe/Madrid",
  subject: {
    vendor_data: "user-42",
    entity_type: "individual",
  },
  session: {
    session_id: "web-session-abc",
    sequence: 142,
  },
  device_context: {
    fingerprint: "fp-a8c1",
    network_context: {
      ip_address: "203.0.113.42",
    },
  },
  payload: { method: "password" },
  custom_values: { vip_tier: "gold" }
)
puts result.to_h

using System;
using System.Collections.Generic;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.MonitoringEvents.CreateAsync(new MonitoringEventCreateRequest
{
    EventId = "login-2026-10-17-000001",
    EventCategory = "auth",
    ActionType = "login",
    OccurredAt = DateTimeOffset.Parse("2026-10-17T09:15:02.481Z"),
    TimeZone = "Europe/Madrid",
    Subject = new()
    {
        VendorData = "user-42",
        EntityType = "individual",
    },
    Session = new MonitoringEventCreateRequestSession
    {
        SessionId = "web-session-abc",
        Sequence = 142,
    },
    DeviceContext = new MonitoringEventCreateRequestDeviceContext
    {
        Fingerprint = "fp-a8c1",
        NetworkContext = new MonitoringEventCreateRequestDeviceContextNetworkContext
        {
            IpAddress = "203.0.113.42",
        },
    },
    Payload = new Dictionary<string, object> { ["method"] = "password" },
    CustomValues = new Dictionary<string, object> { ["vip_tier"] = "gold" },
});
Console.WriteLine(JsonSerializer.Serialize(result));