Bias Detection

Real-time bias detection across demographics — FDA AI/ML Guidelines Section IV.B compliance.

POST /detect-bias

Detect bias in a single decision across demographic subgroups.

Request

{
  "decision_id": "string",
  "subgroups": {
    "gender": "string",
    "age_group": "string",
    "ethnicity": "string",
    "custom": {}
  }
}

Field	Type	Required	Description
decision_id	string	✅	Decision to analyze
subgroups	object	✅	Demographic attributes
subgroups.gender	string	❌	Gender category
subgroups.age_group	string	❌	Age bracket
subgroups.ethnicity	string	❌	Ethnicity category
subgroups.custom	object	❌	Custom subgroups

Response

{
  "bias_detected": true,
  "bias_type": "accuracy_disparity",
  "affected_subgroups": ["age_group:65+"],
  "severity": "high",
  "disparity_percentage": 25,
  "recommendation": "Immediate review required (EU AI Act Article 10)",
  "regulation_mapping": {
    "eu_ai_act": "Article 10",
    "texas_traiga": "§ 2056.103",
    "fda": "Section IV.B"
  }
}

Bias Types

Type	Description
accuracy_disparity	AI accuracy varies by group
representation_disparity	Group underrepresented
treatment_disparity	Different recommendations for similar cases

Severity Levels

Severity	Criteria
high	Disparity >20% OR >100 users affected
medium	Disparity 10-20% OR 50-100 users affected
low	Disparity <10% OR <50 users affected

Example

curl -X POST https://api.athenatrust.ai/v1/detect-bias \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "decision_id": "dec_abc123",
    "subgroups": {
      "gender": "female",
      "age_group": "65+"
    }
  }'

---

GET /bias/feed

Real-time feed of bias alerts (Texas TRAIGA § 2056.103).

Request

GET /bias/feed?severity=high&limit=50

Param	Type	Required	Description
severity	string	❌	Filter by severity (high/medium/low)
limit	number	❌	Max results (default: 50)

Response

{
  "alerts": [
    {
      "id": "alert_789",
      "timestamp": "2025-12-25T10:00:00Z",
      "bias_type": "accuracy_disparity",
      "affected_subgroup": "age_group:65+",
      "severity": "high",
      "affected_users": 12,
      "disparity_percentage": 25,
      "recommendation": "Immediate intervention required"
    }
  ],
  "total": 47,
  "has_more": true
}

Example

curl -X GET "https://api.athenatrust.ai/v1/bias/feed?severity=high&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

GET /bias/subgroups

Subgroup performance analysis (FDA AI/ML Guidelines Section IV).

Request

GET /bias/subgroups?days=30

Param	Type	Required	Description
days	number	❌	Time window (default: 30)

Response

{
  "subgroups": [
    {
      "subgroup": "gender:female",
      "ai_accuracy": 0.85,
      "sample_size": 234,
      "bias_detected": false
    },
    {
      "subgroup": "age_group:65+",
      "ai_accuracy": 0.62,
      "sample_size": 89,
      "bias_detected": true,
      "severity": "high",
      "disparity_percentage": 23
    }
  ]
}

Example

curl -X GET "https://api.athenatrust.ai/v1/bias/subgroups?days=30" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

SDK Examples

JavaScript

import { Athena } from '@athena-ai/sdk';

const athena = new Athena({ apiKey: 'YOUR_API_KEY' });

// Detect bias
const result = await athena.bias.detect({
  userId: 'user_123',
  decision: {
    actionTaken: 'approved',
    aiRecommended: 'approved'
  }
});

if (result.biasDetected) {
  console.log(`Bias: ${result.biasType}`);
  console.log(`Severity: ${result.severity}`);
}

// Get bias feed
const feed = await athena.bias.feed({
  severity: 'high',
  limit: 50
});

// Get subgroup analysis
const subgroups = await athena.bias.subgroups({ days: 30 });

Python

from athena import Athena

athena = Athena(api_key='YOUR_API_KEY')

# Detect bias
result = athena.bias.detect(
    user_id='user_123',
    action_taken='approved',
    ai_recommended='approved'
)

if result.bias_detected:
    print(f"Bias: {result.bias_type}")
    print(f"Severity: {result.severity}")

# Get bias feed
feed = athena.bias.feed(severity='high', limit=50)

# Get subgroup analysis
subgroups = athena.bias.subgroups(days=30)

---

Next: Audit Trail API