Developer API

Integrate Shariah compliance screening into your app, fintech, or research platform.

4,300+

Stocks Covered

AAOIFI

Standard

REST

JSON API

Base URL

https://halalscreener.app/api/v1

Authentication

Include your API key in the Authorization header:

Authorization: Bearer hs_live_your_key_here

Rate Limits

10/min

Free

60/min

Pro

200/min

Premium

Screen a single stock for Shariah compliance.

Parameters

symbolrequired — Stock ticker (e.g. AAPL, TSLA)

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://halalscreener.app/api/v1/screen?symbol=AAPL"

Response

{
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "status": "halal",
  "score": 87,
  "grade": "A",
  "gradeLabel": "Very Good",
  "sector": "Technology",
  "financials": {
    "debtToMarketCap": 0.035,
    "depositsToMarketCap": 0.022,
    "prohibitedIncomePct": 0.001
  },
  "screenedAt": "2026-02-27T00:00:00.000Z",
  "url": "https://halalscreener.app/en/stock/AAPL"
}

Use Cases

Robo-Advisors

Filter investment options for Shariah-compliant portfolios

Fintech Apps

Add halal compliance badges to your stock listings

Research Platforms

Enrich financial data with compliance scores

Islamic Banks

Screen investment products against AAOIFI standards

Need help? Email us at support@halalscreener.app