Skip to main content

​
What is an Evidence Packet?

An Evidence Packet is a self-contained compliance audit bundle for a single instrument. It includes the determination, every financial metric with its calculation, the source filings and XBRL tags used, confidence details, and historical stability metrics. This is what turns a “screening result” into a defensible compliance decision. ETF issuers, advisors, and fund managers use Evidence Packets to:
  • Document screening decisions for Shariah boards
  • Satisfy regulatory audit requirements
  • Build compliance reports for clients
  • Track stability and threshold proximity over time

​
Schema

{
  "instrument": {
    "symbol": "NVDA",
    "name": "NVIDIA Corporation",
    "exchange": "NASDAQ"
  },
  "as_of": "2026-03-08",
  "period": "FY2025",
  "currency": "USD",

  "methodology": {
    "id": "aaoifi_standard_21",
    "version": "2026.1",
    "name": "AAOIFI Standard No. 21 (2021 Revision)"
  },

  "determination": {
    "status": "compliant",
    "confidence": 0.94,
    "reason_codes": ["all_screens_pass", "high_data_quality"],
    "purification": {
      "required": true,
      "percentage": 1.8
    }
  },

  "screens": [
    {
      "name": "business_activity",
      "result": "pass",
      "detail": {
        "primary_activities": ["Semiconductors", "GPU Computing"],
        "prohibited_activities": [],
        "activity_compliance": "permissible",
        "concerns": []
      }
    },
    {
      "name": "debt_to_market_cap",
      "result": "pass",
      "metric": {
        "value": 0.082,
        "threshold": 0.30,
        "operator": "<=",
        "formula": "total_interest_bearing_debt / avg_market_cap_12m",
        "numerator": {
          "value": 11520000000,
          "label": "Total Interest-Bearing Debt",
          "components": {
            "long_term_debt": 9709000000,
            "current_portion": 1811000000
          }
        },
        "denominator": {
          "value": 140400000000,
          "label": "12-Month Avg Market Cap",
          "method": "12-month-avg",
          "months_used": 12
        }
      },
      "sources": [
        {
          "filing_type": "10-K",
          "accession_number": "0001045810-25-000032",
          "period_end": "2025-01-26",
          "filing_date": "2025-02-26",
          "xbrl_tags": [
            "us-gaap:LongTermDebt",
            "us-gaap:ShortTermBorrowings"
          ],
          "extraction_strategy": "PrimaryFields",
          "raw_values": {
            "LongTermDebt": 9709000000,
            "ShortTermBorrowings": 1811000000
          }
        }
      ]
    }
  ],

  "confidence_detail": {
    "score": 0.94,
    "base_confidence": 1.0,
    "extraction_strategies_used": ["PrimaryFields"],
    "fallbacks_used": [],
    "penalties": [],
    "boosts": [
      {
        "type": "xbrl_validated",
        "impact": 0.02,
        "reason": "XBRL data cross-validated against filing text"
      }
    ]
  },

  "stability": {
    "quarters_compliant": 8,
    "quarters_total": 8,
    "flip_rate": 0.0,
    "closest_threshold": {
      "screen": "cash_receivables_to_market_cap",
      "current_distance": 0.105,
      "median_distance": 0.12,
      "trend": "stable"
    },
    "stability_rating": "stable",
    "stability_drivers": [
      {
        "code": "consistent_compliance",
        "message": "Compliant for 8 consecutive quarters",
        "severity": "info"
      }
    ]
  },

  "disclosures": [
    "Market cap denominator uses 12-month trailing average per AAOIFI Standard 21.",
    "Revenue is trailing twelve months (TTM) from 10-K FY2025 + subsequent 10-Qs.",
    "Interest income extracted from income statement using PrimaryFields strategy."
  ]
}

​
Key properties

​
screens[]

Each screen includes the result (pass/fail), the calculated metric with numerator, denominator, and threshold, and the sources — the actual SEC filings and XBRL tags the values were extracted from.

​
confidence_detail

Breaks down the confidence score: what started as the base, what penalties were applied (stale data, extraction fallbacks), and what boosts were earned (cross-validation, high data quality).

​
stability

Historical compliance behavior: how many quarters the stock has been compliant, the flip rate (how often it changes status), and which threshold it’s closest to breaching. This helps portfolio managers assess rebalancing risk.

​
sources[]

Every metric traces back to:
  • Filing type — 10-K, 10-Q, 20-F, or 40-F
  • Accession number — SEC EDGAR unique filing identifier
  • XBRL tags — the exact taxonomy elements used
  • Extraction strategy — how the value was obtained (PrimaryFields, MaturityBuckets, ComponentSum, etc.)
  • Raw values — the numbers as they appear in the filing

​
Availability

Evidence Packets are available on all plans — 5/month on Sandbox, unlimited on Pro. 
curl https://api.halal.sh/v1/instruments/NVDA/evidence \
  -H "X-API-Key: hsh_live_abc123..."