Score Signup

Analyze signup data and returns a trust score from 0-100 with detailed reasoning and risk classification.

POST/score-signup🔒 Auth Required

Analyzes signup data using 4 parallel processors (Email Intelligence, Network Analysis, Velocity Checks, Device Fingerprint) and returns a weighted trust score.

Request Body

ParameterTypeRequiredDescription
emailstringRequiredThe email address to analyze
ip_addressstringRequiredThe IP address of the signup attempt
user_agentstringOptionalBrowser user agent string

Request Example

cURL
curl -X POST https://api.siftlyapi.com/score-signup \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"email": "jane.smith@company.com",
"ip_address": "203.0.113.1",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
}'

Response

Returns a JSON response with trust score and analysis:

200 OK — Low Risk
1{
2 "trust_score": 95,
3 "risk_level": "low",
4 "reasons": [
5 {
6 "factor": "email",
7 "score": 95,
8 "reason_code": "corporate_email",
9 "description": "Corporate email domain with high trust score",
10 "risk_level": "low"
11 },
12 {
13 "factor": "ip_address",
14 "score": 85,
15 "reason_code": "residential_ip",
16 "description": "Residential IP address from trusted ISP",
17 "risk_level": "low"
18 },
19 {
20 "factor": "velocity",
21 "score": 85,
22 "reason_code": "normal_velocity",
23 "description": "Normal signup velocity patterns detected",
24 "risk_level": "low"
25 },
26 {
27 "factor": "user_agent",
28 "score": 95,
29 "reason_code": "standard_browser",
30 "description": "Standard web browser user agent detected",
31 "risk_level": "low"
32 }
33 ],
34 "request_id": "123e4567-e89b-12d3-a456-426614174000",
35 "processed_at": "2025-01-15T10:30:00Z"
36}

Response Fields

FieldTypeDescription
trust_scoreintegerOverall trust score (0-100)
risk_levelstringlow, medium, or high
reasonsarrayDetailed breakdown of each scoring factor
request_iduuidUnique request identifier for support