API Documentation

Multi-country tickers

The Akinda API audits three markets today — United States, United Kingdom, and Canada. Country is auto-detected from the ticker, so you never pass a country parameter on the per-ticker path. The response carries the matching listing_country (ISO-2) and reporting_currency (ISO-4217) fields so downstream code can format dollar amounts in the company's native currency. No FX conversion ever happens — every numeric field is denominated in reporting_currency.

Coverage launched with the 2026-06-15 Coverage Expansion release (LSE-UK ~355 names + TSX-Canada ~72 names). Live uptime and per-endpoint coverage stats are on /developer/docs/status — those numbers come straight from the backend and update in real time, never from a static cache. Additional markets are tracked on the Roadmap.

MCP Server

Connect Claude to Akinda's Shariah screening and ask in plain language — check compliance, pull reports, screen a portfolio, or calculate purification without leaving the chat. Each tool call is a metered API request on your plan.

1. Shariah Compliance Status — /COMPLIANCE

Available to all tiers. The fastest halal / non-halal verdict — send a ticker, get a single AAOIFI-aligned status string back. Use it in search bars, watchlists, and live-feed filters where you just need a yes-or-no answer.

{
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "listing_country": "US",
  "reporting_currency": "USD",
  "halal_status": "HALAL"
}

2. Basic Shariah Compliance Report — /BASIC-REPORT

Requires Personal Standard tier or above. Returns the three core AAOIFI ratios on top of the compliance status — everything you need to display a transparent screening breakdown.

{
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "listing_country": "US",
  "reporting_currency": "USD",
  "halal_status": "HALAL",
  "debt_ratio_perc": 3.07,
  "liquidity_ratio_perc": 1.70,
  "non_compliant_revenue_perc": 0
}

3. Full Shariah Compliance Report — /FULL-REPORT

Requires Personal Ultimate tier or above. Adds AI-extracted SEC filing analysis, USD dollar amounts for every ratio, doubtful / compliant revenue pairs, and per-source revenue breakdowns. This is the full payload behind every stock detail page on the Akinda dashboard.

{
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "listing_country": "US",
  "reporting_currency": "USD",
  "halal_status": "HALAL",
  "halal_rating": 7,
  "force_haram": false,
  "debt_ratio_perc": 12.34,
  "liquidity_ratio_perc": 7.89,
  "non_compliant_revenue_perc": 1.74,
  "interest_debt": 110000000000,
  "prohibited_revenue": 5000000000,
  "operating_lease": 14000000000,
  "last_scanned": "2026-03-14T04:49:00Z",
  "debt_ratio_dollar": 110000000000,
  "liquidity_ratio_dollar": 65000000000,
  "non_compliant_revenue_dollar": 4920000000,
  "doubtful_revenue_perc": 1.15,
  "doubtful_revenue_dollar": 2600000000,
  "compliant_revenue_perc": 97.84,
  "compliant_revenue_dollar": 218000000000,
  "halal_revenue_source": [
    { "name": "Services", "percent": 85.25, "amount_usd": 189000000000 },
    { "name": "iPhone", "percent": 12.51, "amount_usd": 27000000000 }
  ],
  "non_compliant_revenue_source": [
    { "name": "Apple Card interest", "percent": 1.01, "amount_usd": 4920000000 }
  ],
  "doubtful_revenue_source": [
    { "name": "Apple Music streaming", "percent": 1.15, "amount_usd": 2600000000 }
  ],
  "ranking_score": 7.80,
  "profitability_score": 8.20,
  "liquidity_score": 7.40,
  "financial_strength_score": 8.50,
  "value_score": 5.90,
  "growth_score": 7.60,
  "momentum_score": 8.10,
  "dividend_score": 5.20
}