curl --request POST \
--url https://api.signuprisk.com/v1/analyze-email \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "person@example.com"
}
'{
"email": {
"input": "person@example.com",
"normalized": "person@example.com",
"normalized_preserving_case": "person@example.com",
"canonical": "person@example.com",
"is_well_formed": true,
"format_issues": [],
"format_explanation": "The email address is structurally well formed. This does not mean it is safe, trusted, deliverable, or non-disposable.",
"is_internationalized": false
},
"decision": {
"action": "block",
"risk_score": 100,
"risk_band": "very_high",
"summary": "Very high-risk signup. Primary concern: IANA-reserved special-use domain that can never receive email.",
"assessment": {
"confidence": "medium",
"evidence_strength": "strong",
"evidence_coverage": "broad",
"uncertainty": "low",
"limitations": []
}
},
"metadata": {
"warnings": [],
"usage": {
"requests": {
"used": 1,
"limit": 10000,
"unlimited": false,
"remaining": 9999
},
"explanations": {
"used": 0,
"limit": 500,
"unlimited": false,
"remaining": 500
}
},
"plan": {
"current_plan": "Developer",
"billing_period": {
"starts": "2026-09-16T00:00:00Z",
"ends": "2026-10-16T00:00:00Z"
},
"reset_at": "2026-10-16T00:00:00Z"
},
"assessment_version": "2026.08.28"
}
}API Reference
Analyze a single email
Synchronously score one email. Consumes one request-unit and (if
requested) one explanation-unit against the monthly quota window.
Required scope: analyze. The caller’s plan gates premium checks
(IP reputation = Growth, industry profiles = Scale).
POST
/
v1
/
analyze-email
curl --request POST \
--url https://api.signuprisk.com/v1/analyze-email \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "person@example.com"
}
'{
"email": {
"input": "person@example.com",
"normalized": "person@example.com",
"normalized_preserving_case": "person@example.com",
"canonical": "person@example.com",
"is_well_formed": true,
"format_issues": [],
"format_explanation": "The email address is structurally well formed. This does not mean it is safe, trusted, deliverable, or non-disposable.",
"is_internationalized": false
},
"decision": {
"action": "block",
"risk_score": 100,
"risk_band": "very_high",
"summary": "Very high-risk signup. Primary concern: IANA-reserved special-use domain that can never receive email.",
"assessment": {
"confidence": "medium",
"evidence_strength": "strong",
"evidence_coverage": "broad",
"uncertainty": "low",
"limitations": []
}
},
"metadata": {
"warnings": [],
"usage": {
"requests": {
"used": 1,
"limit": 10000,
"unlimited": false,
"remaining": 9999
},
"explanations": {
"used": 0,
"limit": 500,
"unlimited": false,
"remaining": 500
}
},
"plan": {
"current_plan": "Developer",
"billing_period": {
"starts": "2026-09-16T00:00:00Z",
"ends": "2026-10-16T00:00:00Z"
},
"reset_at": "2026-10-16T00:00:00Z"
},
"assessment_version": "2026.08.28"
}
}Authorizations
First-party API key. Send the canonical key as a Bearer token:
Authorization: Bearer eisk_live_eik_<24hex>_<64hex>
Used on all API-client routes (/v1/analyze-email, batch, bulk,
customer webhooks). Scopes (analyze, bulk, webhooks) authorize a
route; the account plan authorizes premium functionality.
Headers
Body
application/json
Response
Analysis result.
Decision-first analysis response. checks and explanation are omitted when not produced.