API V2

Enterprise API

Shariah screening data for listed companies. Your API key unlocks one of three plans: Demo, Basic, or Advanced.

Quick start

  1. Log in and copy your API key from your profile.
  2. Call the base URL below with apikey=… (or a Bearer header).
  3. Start with the example for your plan — Basic, Advanced, or Demo.

Base URL

https://api.ailat.kz/api/v2/enterpriseunique

All requests are GET, except Advanced batch which is POST …/batch.

Choose a plan

Pick the plan that matches what you need. Your key is already assigned to one of these.

Basic Best for bulk export One endpoint: download the company list with verdict + report dates. 4 fields · 5 000 req/month Advanced Best for screening apps Search, filters, counts, single-symbol lookup, and batch checks with ratios & risk flags. Full summary · 5 000 req/month Demo Best for trying the API Fixed sample of 10 companies in Advanced format. Only list=all — no pagination, search, or batch. Trial · 10 req/month

Authentication

Every request needs your API key. Use either method:

Option A — query string

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=all

Option B — header

Authorization: Bearer YOUR_API_KEY

Basic

Basic — list export

One job: pull the full universe as a paginated list. You only get four fields per company (symbol, verdict, report date, filing date).

  • Allowed: list=all with start / length (max 100)
  • Not allowed: search, filters, count, symbol lookup, batch
  • Quota: 5 000 requests / month

Response uses Result.Companies[] (short 4-field rows).

Try this first

Request

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=all&start=0&length=100

Example response

{
  "Status": "OK",
  "Result": {
    "Companies": [
      {
        "Trading symbol": "AAPL",
        "Shariah_verdict": "Permissible",
        "report date": "2024-09-28",
        "filing date": "2024-11-01"
      }
    ],
    "Total": 2500,
    "Pagination": { "total_count": 2500, "start": 0, "length": 100, "has_next": true },
    "Remaining_requests_this_month": 4999,
    "Monthly_limit": 5000
  }
}

curl

curl "https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=all&start=0&length=100"

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.ailat.kz/api/v2/enterpriseunique?list=all&start=0&length=100"

Advanced

Advanced — screening

Richer data per symbol: verdict, income/debt ratios (%), activity, compliance, risk flags. Raw money amounts (total / halal / haram income) are not included. Quota: 5 000 requests / month.

Rule: send exactly one main parameter per request (list, count, symbol, or search). List pages use length up to 20. Batch accepts up to 50 symbols.

You want…Use
Browse / filter companies list=all (+ optional filters)
Pool or index status list=pool_status / list=index_status
Report dates for a ticker list=availabledates
Aggregates (by country, verdict, …) count=…
One company symbol=AAPL
Text search search=Apple
Many tickers at once POST /batch

List examples

Pool status

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=pool_status

Example response

{
  "Status": "OK",
  "Result": {
    "Symbols": [
      {
        "Name": "AAPL",
        "Verdict changed": "No",
        "Current verdict": "Permissible",
        "Current verdict shariah_acceptance date": "2024-11-01",
        "Risk status total debt": "Green",
        "Risk status total cashes and securities": "Green",
        "Archived status": "Not archived",
        "Previous verdict": "Permissible",
        "Previous shariah_acceptance date": "2023-11-03"
      }
    ],
    "Pagination": { "total_count": 1, "start": 0, "length": 1, "has_next": false }
  }
}

Full list (summary profile)

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=all&start=0&length=20

Returns Result.Symbols[] with ratios and risk fields — not the short 4-field Basic response.

Example response (one item)

{
  "Status": "OK",
  "Result": {
    "Symbols": [
      {
        "name": "1038",
        "company_name": "CK Infrastructure Holdings Ltd",
        "current_verdict": "Permissible",
        "halal_income_ratio": "97.26%",
        "haram_income_ratio": "2.74%",
        "total_debt_ratio": "16.84%",
        "deposits_ratio": "7.25%",
        "risk_status_total_debt": "Green",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      }
    ],
    "Pagination": { "total_count": 5028, "start": 0, "length": 20, "has_next": true }
  }
}

Available report dates

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=availabledates&trading_symbol=AAPL

Example response

{
  "Status": "OK",
  "Result": {
    "trading_symbol": "AAPL",
    "AvailableDates": ["2024-09-28", "2023-09-30", "2022-09-24"],
    "Pagination": { "total_count": 3, "start": 0, "length": 10, "has_next": false }
  }
}

Count example

How many by verdict

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&count=verdict

Example response

{
  "Status": "OK",
  "Result": {
    "verdict": [
      { "Name": "permissible", "Count": 8500 },
      { "Name": "non_permissible", "Count": 3500 },
      { "Name": "unknown", "Count": 345 }
    ]
  }
}

Also: count=country, sector, industry, exchange_short_name, all, new.

Lookup & batch

One symbol

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&symbol=1038

Same summary fields as list=all, for one ticker.

Search by name

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&search=Apple

POST batch

POST https://api.ailat.kz/api/v2/enterpriseunique/batch

{"symbols":["AAPL","MSFT"],"lng":"en"}

Example response

{
  "Status": "OK",
  "Result": [
    {
      "name": "AAPL",
      "company_name": "Apple Inc",
      "current_verdict": "Permissible",
      "halal_income_ratio": "97.26%",
      "total_debt_ratio": "16.84%"
    },
    {
      "name": "MSFT",
      "company_name": "Microsoft Corp",
      "current_verdict": "Permissible",
      "halal_income_ratio": "98.10%",
      "total_debt_ratio": "12.40%"
    }
  ],
  "meta": { "requested_symbols": 2, "found_symbols": 2 }
}

curl

curl "https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=pool_status"
curl "https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&count=verdict"
curl "https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&symbol=AAPL"
curl -X POST "https://api.ailat.kz/api/v2/enterpriseunique/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols":["AAPL","MSFT"],"lng":"en"}'

Demo

Demo — try before you buy

Returns a fixed set of 10 companies in the same summary format as Advanced (Result.Symbols[]).

  • Only list=all is allowed (plus apikey / lng)
  • Do not send start or length — they are rejected
  • No search, count, symbol lookup, or batch
  • Quota: 10 requests / month

Try this first

https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=all