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
}
}Returns a complete compliance audit bundle with determination, every metric with its calculation and source filings, confidence breakdown, and stability metrics.
Returns 404 if the stock’s analysis is still pending. Check
/instruments/{symbol}/compliance first to confirm analysis is complete.
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
}
}Stock ticker symbol (e.g., AAPL, NVDA, MSFT).
1 - 10"NVDA"