Decision Intelligence
DECISION INTELLIGENCE API Enterprise Fraud Detection and EU AI Act Compliance Infrastructure OVERVIEW Decision Intelligence API is enterprise-grade fraud detection infrastructure that gives your platform real-time approve, review, or deny decisions in under 100 milliseconds — with a full legal audit trail, AI-powered explanations, EU AI Act compliance, consortium intelligence, and CFO-ready ROI…
Decision Intelligence endpoints
| Method | Endpoint | Description |
|---|---|---|
| Events | ||
| GET |
get_event_v1_events__event_id__get /v1/events/{event_id} |
Retrieve a specific event by ID. |
| POST |
create_event_v1_events_post /v1/events |
Record a user behavior event for tracking and analysis. |
| GET |
list_events_v1_events_get /v1/events |
Retrieve events with optional filtering. |
| Decisions | ||
| GET |
get_decision_v1_decisions__decision_id__get /v1/decisions/{decision_id} |
Retrieve a specific decision by ID. Used for the Decision Detail View in the dashboard. |
| GET |
explain_decision_v1_decisions__decision_id__explain_get /v1/decisions/{decision_id}/explain |
Get forensic details for a decision. |
| GET |
get_evidence_package_v1_decisions__decision_id__evidence_package_get /v1/decisions/{decision_id}/evidence-package |
Generate a signed, tamper-proof PDF evidence package of the decision context. Legally defensible export for auditors and regulators. |
| POST |
replay_decision_v1_decisions__decision_id__replay_post /v1/decisions/{decision_id}/replay |
Re-evaluate an existing decision. Bypasses the decision cache to recalculate with potentially updated policies. |
| POST |
request_decision_v1_decisions_post /v1/decisions |
Evaluate a user action and get a recommended decision based on behavior, policies, and risk. |
| GET |
get_decision_narrative_v1_decisions__decision_id__narrative_get /v1/decisions/{decision_id}/narrative |
Get a plain-English narrative explanation for a decision. Uses LLM to transform technical factors into business-friendly text. |
| GET |
list_decisions_v1_decisions_get /v1/decisions |
List recent decisions for the merchant. Used by the Decision Evidence Dashboard. |
| Feedback | ||
| POST |
submit_feedback_v1_feedback_post /v1/feedback |
Record the actual outcome of a decision for system learning. |
| POST |
submit_decision_outcome_v1_feedback_outcomes_post /v1/feedback/outcomes |
Submit the actual outcome of a decision to enable trust accumulation. This is the critical feedback loop: - Merchant reports what actually happened (legit, fraud, chargeback,… |
| Policy Marketplace | ||
| POST |
adopt_marketplace_policy_v1_policies_marketplace__policy_id__adopt_post /v1/policies/marketplace/{policy_id}/adopt |
Adopt a marketplace policy into the merchant's active ruleset. |
| GET |
list_marketplace_policies_v1_policies_marketplace_get /v1/policies/marketplace |
Browse curated industry-standard risk policies that can be adopted instantly. |
| Policies | ||
| PATCH |
update_policy_v1_policies__policy_id__patch /v1/policies/{policy_id} |
Update a policy's fields (full patch support). |
| GET |
get_policy_v1_policies__policy_id__get /v1/policies/{policy_id} |
Retrieve a specific policy by ID. |
| POST |
create_policy_from_dsl_v1_policies_from_dsl_post /v1/policies/from-dsl |
Create a policy using natural language DSL syntax. |
| POST |
create_policy_v1_policies_post /v1/policies |
Create a new business rule/policy. |
| DELETE |
delete_policy_v1_policies__policy_id__delete /v1/policies/{policy_id} |
Delete a policy. |
| GET |
get_policy_impact_history_v1_policies__policy_id__impact_history_get /v1/policies/{policy_id}/impact-history |
Track policy hit rates and effectiveness over time. |
| GET |
list_policies_v1_policies_get /v1/policies |
Retrieve all policies with optional filtering. |
| POST |
validate_dsl_v1_policies_validate_dsl_post /v1/policies/validate-dsl |
Validate DSL syntax without creating a policy. |
| Users | ||
| DELETE |
erase_user_data_v1_users__user_id__data_delete /v1/users/{user_id}/data |
Permanently erase all data associated with a user_id for this merchant. Fulfills GDPR Article 17 (Right to Erasure). Returns a signed deletion receipt. Erasure is recorded on the… |
| GET |
get_user_risk_trajectory_v1_users__user_id__risk_trajectory_get /v1/users/{user_id}/risk-trajectory |
Retrieve historical score movements and decisions for a user. |
| GET |
get_user_summary_v1_users__user_id__summary_get /v1/users/{user_id}/summary |
Retrieve the behavioral profile and memory for a user. |
| Outcomes | ||
| GET |
get_outcome_analysis_v1_outcomes_analysis_get /v1/outcomes/analysis |
Get aggregated outcome metrics and analysis. Returns accuracy, precision, recall, false positive/negative rates, and cost impact analysis. |
| POST |
submit_outcome_v1_outcomes__post /v1/outcomes/ |
Submit ground truth outcome for a decision. This enables the system to learn from feedback and calculate accuracy metrics. Example: { "decision_id": "abc-123-def-456",… |
| GET |
list_outcomes_v1_outcomes__get /v1/outcomes/ |
List outcomes with pagination and filtering. |
| Analytics | ||
| GET |
get_public_intelligence_v1_analytics_intelligence_get /v1/analytics/intelligence |
Public-facing intelligence signals. Anonymized global metrics to demonstrate network effects. |
| GET |
get_llm_health_v1_analytics_llm_health_get /v1/analytics/llm-health |
LLM cost, health, and observability metrics. Powers the Intelligence panel on the System Health dashboard tab. |
| GET |
get_false_positive_report_v1_analytics_false_positives_get /v1/analytics/false-positives |
Detailed breakdown of why false positives occur. |
| GET |
get_accuracy_metrics_v1_analytics_accuracy_get /v1/analytics/accuracy |
Calculate accuracy metrics based on merchant-reported outcomes. Powers the 'Model Performance' dashboard card. |
| GET |
get_abuse_analytics_v1_analytics_anomalies_get /v1/analytics/anomalies |
Get aggregated abuse and anomaly metrics. Core backend for the 'Abuse & Anomaly Monitor' dashboard screen. |
| GET |
get_cohort_comparison_v1_analytics_cohort_comparison_get /v1/analytics/cohort-comparison |
Compare merchant metrics against anonymized peers in the same industry cohort. (Phase 7.3) |
| GET |
get_merchant_usage_v1_analytics_usage_get /v1/analytics/usage |
Get customer-visible usage telemetry (R.6). Tenant isolation (R.2) is automatically enforced at the ORM layer. |
| GET |
get_benchmark_comparison_v1_analytics_benchmark_get /v1/analytics/benchmark |
Compare merchant latency and AI conversion rates against global network averages. (Phase 7.4) |
| GET |
get_revenue_impact_v1_analytics_revenue_impact_get /v1/analytics/revenue-impact |
Calculate saved revenue vs friction cost. Estimates ROI of the Decision Intelligence solution. |
| Webhooks | ||
| GET |
list_webhook_logs_v1_webhooks__webhook_id__logs_get /v1/webhooks/{webhook_id}/logs |
Retrieve recent delivery logs for a specific webhook. |
| GET |
list_webhooks_v1_webhooks_get /v1/webhooks |
List all active webhook subscriptions for the merchant. |
| GET |
get_webhook_v1_webhooks__webhook_id__get /v1/webhooks/{webhook_id} |
Retrieve details for a specific webhook subscription. |
| DELETE |
delete_webhook_v1_webhooks__webhook_id__delete /v1/webhooks/{webhook_id} |
Delete a webhook subscription. |
| POST |
create_webhook_v1_webhooks_post /v1/webhooks |
Subscribe to system events via a webhook URL. Returns the secret key used for signing payloads. |
| PATCH |
update_webhook_v1_webhooks__webhook_id__patch /v1/webhooks/{webhook_id} |
Update a webhook subscription. |
| System | ||
| GET |
get_data_room_v1_system_dataroom_get /v1/system/dataroom |
Generate an automated Data Room report for technical due diligence. Summarizes security architecture, infrastructure choices, and system SLAs. |
| GET |
get_system_status_v1_system_status_get /v1/system/status |
Public status page data. |
| Intelligence | ||
| POST |
run_simulation_v1_intelligence_simulate_post /v1/intelligence/simulate |
Replay historical events against a draft policy to see outcome shifts. |
| GET |
get_bias_analysis_v1_intelligence_bias_report_get /v1/intelligence/bias-report |
Audit merchant decisions for statistical parity and proxy bias. |
| POST |
analyze_counterfactual_v1_intelligence_counterfactual__decision_id__post /v1/intelligence/counterfactual/{decision_id} |
Get a 'What-If' analysis for a specific decision. Finds the smallest change to inputs that would flip the outcome. |
| Regulatory | ||
| GET |
get_ai_act_report_v1_regulatory_ai_act_report_get /v1/regulatory/ai-act-report |
EU AI Act Transparency Report (Articles 13 & 14). Auto-generates systemic transparency and human oversight metrics. |
| GET |
get_compliance_controls_v1_regulatory_controls_get /v1/regulatory/controls |
Real-time SOC 2/Compliance Control status. Shows the security posture of the individual merchant's data. |
Decision Intelligence pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $49 / month | 60 / minute |
|
| ULTRA | $299 / month | 300 / minute |
|