Compliance Rail

Regulatory and Shariah compliance checking endpoints.

Overview

The Compliance rail provides:

• Shariah compliance validation
• Regulatory framework checks
• Jurisdiction-specific rules
• Compliance reporting

Endpoints

Check Compliance

POST /v1/compliance/check

const check = await iof.compliance.check({
  resourceType: "contract",
  resourceId: "contract_123",
  frameworks: ["shariah", "bnm"],
});

Response:

{
  "id": "check_abc",
  "resourceId": "contract_123",
  "compliant": true,
  "checks": [
    {
      "framework": "shariah",
      "rules": [
        { "rule": "no_riba", "passed": true },
        { "rule": "asset_backed", "passed": true }
      ]
    },
    {
      "framework": "bnm",
      "rules": [{ "rule": "disclosure", "passed": true }]
    }
  ]
}

Get Check

GET /v1/compliance/checks/:id

const check = await iof.compliance.getCheck("check_abc");

List Frameworks

GET /v1/compliance/frameworks

const frameworks = await iof.compliance.listFrameworks({
  jurisdiction: "MY",
});

Create Alert

POST /v1/compliance/alerts

const alert = await iof.compliance.createAlert({
  type: "threshold",
  conditions: {
    metric: "daily_volume",
    operator: "gt",
    value: 1000000,
  },
  actions: [{ type: "webhook", url: "https://..." }],
});

Generate Report

POST /v1/compliance/reports

const report = await iof.compliance.generateReport({
  type: "AAOIFI_FAS",
  period: {
    start: "2024-01-01",
    end: "2024-12-31",
  },
  format: "pdf",
});

Compliance Frameworks

Framework	Description	Jurisdiction
shariah	Islamic finance principles	Global
bnm	Bank Negara Malaysia	Malaysia
cbuae	Central Bank of UAE	UAE
sama	Saudi Arabian Monetary Authority	Saudi Arabia
aaoifi	Accounting standards	Global

Rule Categories

Category	Description
shariah	Islamic law compliance
regulatory	Regulatory requirements
disclosure	Transparency requirements
reporting	Reporting obligations
operational	Operational standards

Webhooks

Event	Description
compliance.check.completed	Check completed
compliance.alert.triggered	Alert triggered
compliance.report.ready	Report generated

Next Steps

• AML Rail - Anti-money laundering
• Contracts Rail - Contract compliance