[NEB-4778] Add KYC, geo, and bot-detection structured fields

CHANGES.MD

@@ -1,5 +1,12 @@
 # CHANGES
 
+## 1.8.0 (2026-08-25)
+
+### Added
+- **`$nationality`**, **`$year_of_birth`** fields in `$create_account`, `$update_account` events
+- **`$kyc`** complex type in `$create_account`, `$update_account`, `$transaction`, `$create_order`, `$update_order`, `$verification` events
+- **`$geo`**, **`$bot_identification`** complex types in `$create_account`, `$update_account`, `$login`, `$transaction`, `$create_order`, `$update_order` events
+
 ## 1.7.0 (2025-12-03)
 
 ### Added

README.md

@@ -4,7 +4,7 @@
 
 The official Sift .NET client, supporting .NET Standard 2.0+
 
-## Latest Release (v1.7.0)
+## Latest Release (v1.8.0)
 
 See [CHANGES.MD](CHANGES.MD) for full release history.
 

Sift/Schema/ComplexTypes/bot_identification.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "BotIdentification",
+  "type": "object",
+  "required": [
+    "$result",
+    "$provider"
+  ],
+  "properties": {
+    "$result": {
+      "type": [ "string", "null" ]
+    },
+    "$provider": {
+      "type": [ "string", "null" ]
+    }
+  }
+}

Sift/Schema/ComplexTypes/geo.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "Geo",
+  "type": "object",
+  "required": [
+    "$uuid",
+    "$provider"
+  ],
+  "properties": {
+    "$uuid": {
+      "type": [ "string", "null" ]
+    },
+    "$provider": {
+      "type": [ "string", "null" ]
+    }
+  }
+}

Sift/Schema/ComplexTypes/kyc.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "Kyc",
+  "type": "object",
+  "properties": {
+    "$names_match": {
+      "type": [ "boolean", "null" ]
+    },
+    "$kyc_level": {
+      "type": [ "string", "null" ]
+    },
+    "$bin_nationality_match": {
+      "type": [ "boolean", "null" ]
+    },
+    "$provider": {
+      "type": [ "string", "null" ]
+    }
+  }
+}

Sift/Schema/create_account.json

@@ -85,6 +85,30 @@
     },
     "$ip": {
       "type": [ "string", "null" ]
+    },
+    "$nationality": {
+      "type": [ "string", "null" ]
+    },
+    "$year_of_birth": {
+      "type": [ "integer", "null" ]
+    },
+    "$kyc": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/kyc.json" },
+        { "type": "null" }
+      ]
+    },
+    "$geo": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/geo.json" },
+        { "type": "null" }
+      ]
+    },
+    "$bot_identification": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/bot_identification.json" },
+        { "type": "null" }
+      ]
     }
   }
 }

Sift/Schema/create_order.json

@@ -120,6 +120,24 @@
     },
     "$ip": {
       "type": [ "string", "null" ]
+    },
+    "$kyc": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/kyc.json" },
+        { "type": "null" }
+      ]
+    },
+    "$geo": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/geo.json" },
+        { "type": "null" }
+      ]
+    },
+    "$bot_identification": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/bot_identification.json" },
+        { "type": "null" }
+      ]
     }
   }
 }

Sift/Schema/login.json

@@ -59,6 +59,18 @@
     },
     "$verification_phone_number": {
       "type": [ "string", "null" ]
+    },
+    "$geo": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/geo.json" },
+        { "type": "null" }
+      ]
+    },
+    "$bot_identification": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/bot_identification.json" },
+        { "type": "null" }
+      ]
     }
   }
 }

Sift/Schema/transaction.json

@@ -162,6 +162,24 @@
     "$new_balance": {
       "type": [ "integer", "null" ],
       "format": "long"
+    },
+    "$kyc": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/kyc.json" },
+        { "type": "null" }
+      ]
+    },
+    "$geo": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/geo.json" },
+        { "type": "null" }
+      ]
+    },
+    "$bot_identification": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/bot_identification.json" },
+        { "type": "null" }
+      ]
     }
   }
 }

Sift/Schema/update_account.json

@@ -88,6 +88,30 @@
     },
     "$ip": {
       "type": [ "string", "null" ]
+    },
+    "$nationality": {
+      "type": [ "string", "null" ]
+    },
+    "$year_of_birth": {
+      "type": [ "integer", "null" ]
+    },
+    "$kyc": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/kyc.json" },
+        { "type": "null" }
+      ]
+    },
+    "$geo": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/geo.json" },
+        { "type": "null" }
+      ]
+    },
+    "$bot_identification": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/bot_identification.json" },
+        { "type": "null" }
+      ]
     }
   }
 }

Sift/Schema/update_order.json

@@ -119,6 +119,24 @@
     },
     "$ip": {
       "type": [ "string", "null" ]
+    },
+    "$kyc": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/kyc.json" },
+        { "type": "null" }
+      ]
+    },
+    "$geo": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/geo.json" },
+        { "type": "null" }
+      ]
+    },
+    "$bot_identification": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/bot_identification.json" },
+        { "type": "null" }
+      ]
     }
   }
 

Sift/Schema/verification.json

@@ -55,6 +55,12 @@
     },
     "$ip": {
       "type": [ "string", "null" ]
+    },
+    "$kyc": {
+      "oneOf": [
+        { "$ref": "ComplexTypes/kyc.json" },
+        { "type": "null" }
+      ]
     }
   }
 }

Sift/Sift.csproj

@@ -4,8 +4,8 @@
     <Authors>Sift</Authors>
     <AssemblyTitle>Sift</AssemblyTitle>
     <AssemblyName>Sift</AssemblyName>
-    <VersionPrefix>1.7.0</VersionPrefix>
-    <PackageReleaseNotes>Release 1.7.0</PackageReleaseNotes>
+    <VersionPrefix>1.8.0</VersionPrefix>
+    <PackageReleaseNotes>Release 1.8.0</PackageReleaseNotes>
     <TargetFramework>netstandard2.0</TargetFramework>
     <PackageId>Sift</PackageId>
     <PackageTags>sift;siftscience;client;api;client;async</PackageTags>