Insurance Partner API

Real-Time Risk Scoring
& Analytics

Industry-standard REST API for member risk assessment, batch screening, and historical cohort analysis. Built for insurance partners seeking real-time problem gambling detection.

Get StartedView Endpoints
POST /api/risk-score • POST /api/batch-screening • GET /api/cohorts

API Overview

Three powerful endpoints for comprehensive member risk management and analytics

📊

Risk Scoring

Real-time assessment of member risk profiles based on behavioral signals and betting patterns.

⚡

Batch Screening

Asynchronous processing of up to 10,000 members per request for bulk risk assessment.

📈

Cohort Analytics

Historical aggregated data by age, location, and engagement for trend analysis and benchmarking.

API Endpoints

POST/api/risk-score

Calculate risk score for a single member

Parameters:

  • • member_id (UUID)

Response Example:

{
  "success": true,
  "member_id": "uuid...",
  "risk_level": "MEDIUM",
  "risk_score": 62,
  "risk_confidence": 0.85,
  "recommendation": "Monitor activity closely"
}
POST/api/batch-screening

Asynchronously screen multiple members

Parameters:

  • • member_ids (UUID array, max 10,000)

Response Example:

{
  "job_id": "batch-...",
  "status": "processing",
  "member_count": 100
}
GET/api/cohorts

Retrieve cohort analytics with optional filtering

Parameters:

  • • age_bracket (optional)
  • • country (optional)

Response Example:

{
  "cohorts": [
    {
      "age_bracket": "18-24",
      "country": "US",
      "member_count": 1234,
      "avg_daily_wagers": 45.5
    }
  ],
  "count": 1
}

API Key Authentication

Industry-standard API key authentication with SHA256 hashing

X-API-Key Header

Simple header-based authentication (recommended)

X-API-Key: your-api-key-here

Bearer Token

OAuth-style Bearer token authentication

Authorization: Bearer your-api-key-here

🔒 Security Features

  • ✓SHA256 Key Hashing: Keys are one-way hashed—raw keys never stored or transmitted
  • ✓Rate Limiting: 1,000 requests/hour per API key
  • ✓Audit Logging: Every request logged with partner ID, endpoint, status, and latency
  • ✓Data Anonymization: Only anonymized user IDs returned—never exposes raw user identifiers
  • ✓HTTPS Only: All endpoints require HTTPS for transport security

Code Examples

Ready-to-use curl commands for each endpoint

Get Risk Score

Calculate risk profile for a single member

curl -X POST https://api.edgeactive.app/api/risk-score \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "member_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }'

Batch Screen Members

Asynchronously screen up to 10,000 members

curl -X POST https://api.edgeactive.app/api/batch-screening \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "member_ids": [
      "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "a47ac10b-58cc-4372-a567-0e02b2c3d480"
    ]
  }'

Get Cohort Analytics

Retrieve aggregated cohort data by demographics

curl -X GET "https://api.edgeactive.app/api/cohorts?age_bracket=18-24&country=US" \
  -H "X-API-Key: your-api-key"

💡 Tip: Replace your-api-key with your actual API key. Replace api.edgeactive.app with your production endpoint URL. All examples use HTTPS for security.

Get Started

Four simple steps to integrate the Insurance Partner API

1

Request API Access

Contact our partnerships team to register your organization

2

Receive API Key

Get a unique API key (SHA256 hashed for security)

3

Integrate Endpoints

Add risk-score, batch-screening, or cohorts to your platform

4

Monitor & Scale

Track usage via audit logs and scale with rate limit headers

Ready to integrate?

Contact our partnerships team to discuss your use case and get started with the Insurance Partner API.

Contact Partnerships

API Base URL: https://insurance-api-gateway.vercel.app

Status Page: status.edgeactive.app