API Reference
Complete reference for the MagenTrust public API endpoints.
Base URL
https://api.magentrust.aiAuthentication
All API requests require authentication via request headers. Include these headers with every request:
API keys are rate-limited and domain-restricted. Generate keys in the dashboard.
Endpoints
/v1/verifyVerify a session and receive verification context. Returns privacy-safe session information without exposing internal scoring logic.
Request Headers
Request Body
{
"session_id": "sess_abc123def456"
}Response
{
"session_id": "sess_abc123def456",
"verdict": "verified",
"score": 0.92,
"risk_band": "low",
"is_human": true,
"sdk_version": "1.2.0"
}/v1/challengeRequest an optional challenge for additional verification. Challenges are passive and do not interrupt user experience.
Request Headers
Response
{
"challenge_id": "ch_xyz789",
"type": "passive",
"expires_at": "2024-01-15T10:30:00Z"
}Challenges are optional and used for additional confidence in high-value flows.
Response Fields
Verification responses provide context, not internal detection logic. Use these fields for attribution and decision-making.
| Field | Type | Description |
|---|---|---|
| session_id | string | Unique identifier for the verification session |
| verdict | string | verified | unverified | review |
| score | number | Relative confidence indicator (0-1) |
| risk_band | string | low | medium | high |
| is_human | boolean | Derived boolean indicating human confidence |
| sdk_version | string | Version of the SDK that collected signals |
Note: MagenTrust does not expose raw signals or scoring logic. Responses are designed for attribution and decision-making, not detection transparency.