Skip to main content
GET
/
instruments
/
{symbol}
/
evidence
Get Evidence Packet
curl --request GET \
  --url https://api.halal.sh/v1/instruments/{symbol}/evidence \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "instrument": {
      "symbol": "<string>",
      "name": "<string>",
      "exchange": "<string>"
    },
    "as_of": "2023-12-25",
    "period": "FY2025",
    "currency": "USD",
    "methodology": {
      "id": "aaoifi-ss21",
      "version": "2026.1",
      "name": "<string>"
    },
    "determination": {
      "status": "compliant",
      "confidence": 123,
      "reason_codes": [
        "<string>"
      ],
      "purification": {
        "required": true,
        "percentage": 1.8
      }
    },
    "screens": [
      {
        "name": "debt_to_market_cap",
        "result": "pass",
        "detail": {
          "primary_activities": [
            "<string>"
          ],
          "prohibited_activities": [
            "<string>"
          ],
          "activity_compliance": "permissible",
          "concerns": [
            "<string>"
          ]
        },
        "metric": {
          "value": 123,
          "threshold": 123,
          "operator": "<=",
          "formula": "total_interest_bearing_debt / avg_market_cap_12m",
          "numerator": {
            "value": 123,
            "label": "<string>",
            "components": {}
          },
          "denominator": {
            "value": 123,
            "label": "<string>",
            "method": "<string>"
          }
        },
        "sources": [
          {
            "filing_type": "10-K",
            "accession_number": "<string>",
            "period_end": "2023-12-25",
            "filing_date": "2023-12-25",
            "xbrl_tags": [
              "<string>"
            ],
            "extraction_strategy": "PrimaryFields",
            "raw_values": {}
          }
        ]
      }
    ],
    "confidence_detail": {
      "score": 123,
      "base_confidence": 123,
      "extraction_strategies_used": [
        "<string>"
      ],
      "fallbacks_used": [
        "<string>"
      ],
      "penalties": [
        {
          "type": "<string>",
          "impact": 123,
          "reason": "<string>"
        }
      ],
      "boosts": [
        {
          "type": "<string>",
          "impact": 123,
          "reason": "<string>"
        }
      ]
    },
    "stability": {
      "quarters_compliant": 8,
      "quarters_total": 8,
      "flip_rate": 0,
      "closest_threshold": {
        "screen": "cash_to_market_cap",
        "current_distance": 0.105,
        "median_distance": 123,
        "trend": "stable"
      },
      "stability_rating": "stable",
      "stability_drivers": [
        {
          "code": "<string>",
          "message": "<string>",
          "severity": "info"
        }
      ]
    },
    "disclosures": [
      "<string>"
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "methodology": "aaoifi-ss21@2024",
    "as_of": "2026-03-08T12:00:00Z",
    "retry_after": 120
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

symbol
string
required

Stock ticker symbol (e.g., AAPL, NVDA, MSFT).

Required string length: 1 - 10
Example:

"NVDA"

Response

Evidence Packet

data
object

Complete compliance audit bundle with full provenance.

meta
object