SentraID API Documentation

The SentraID API enables real-time fraud detection and identity intelligence. All endpoints return JSON and require an X-Api-Key and X-Merchant-Id headers.

POST /api/v1/Events

Submit an event for real-time risk scoring and decisioning.

Request Example

POST https://demo.sentraid.com/api/v1/Events
Content-Type: application/json
X-Api-Key: YOUR_API_KEY
X-Merchant-Id: YOUR_Merchant_Id

{
    "userId": "User_24",
    "eventType": "payment_attempt",
    "sessionId": "SessionId24",
    "ipAddress": "2405:8100:8000:5ca1::17:f1c5",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0",    
    "channel": "Web",
    "screenResolution": "1536x960",
    "timezone": "Atlantic/Reykjavik",
    "platform": "Windows",
    "language": "en-US",
}
        

Response Example

{
    "eventId": "9ac33b74-2986-4047-ad1d-ad2559e07e03",
    "riskScore": 44,
    "decision": "CHALLENGE",
    "confidence": 0.75,
    "recommendedActions": [
        { "type": "REQUIRE_MFA", "priority": "HIGH" },
        { "type": "SEND_EMAIL_VERIFICATION", "priority": "MEDIUM" }
    ],
    "riskBreakdown": { "device": 60, "geo": 0, "behavioral": 95, "ip": 35 },
    "triggeredFactors": [
        "NEW_DEVICE",
        "DEVICE_SHARING_3_USERS",
        "UNUSUAL_HOUR_2",
        "LATE_NIGHT_ACTIVITY",
        "SESSION_DEVICE_SWITCHING",
        "SESSION_IP_SWITCHING",
        "DATACENTER_IP"
    ],
    "processingTimeMs": 1872,
    "processedAt": "2025-08-10T02:11:39.7441168Z"
}
        

GET /api/v1/Events/{EventId}/details

Retrieve detailed analysis for a specific event.

Request Example

GET https://demo.sentraid.com/api/v1/Events/962ba21f-8690-4c03-8128-15af723afd15/details
X-Api-Key: YOUR_API_KEY
X-Merchant-Id: YOUR_Merchant_Id
        

Response Example

{
    "eventId": "962ba21f-8690-4c03-8128-15af723afd15",
    "userId": "User_24",
    "eventType": "login_attempt",
    "riskScore": 5,
    "decision": "ALLOW",
    "createdAt": "2025-08-08T08:51:43.65069Z",
    "processedAt": "2025-08-08T08:51:43.650696Z",
    "riskComponents": [
        {
            "component": "DEVICE",
            "score": 0,
            "details": { "deviceAge": "00:16:49.0275011", "accessCount": 2 }
        },
        {
            "component": "GEO",
            "score": 20,
            "factors": ["LOCATION_MISMATCH_319KM"]
        },
        { "component": "BEHAVIORAL", "score": 0 },
        { "component": "IP", "score": 0 }
    ]
}