Enterprise API Documentation
API v2 at https://api.ailat.kz/api/v2/enterpriseunique.
Allowed requests depend on your account group (assigned in your profile).
Overview
The public API runs on api.ailat.kz.
Two subscription levels — see which one matches your API key.
| Access level | What you can call |
|---|---|
| List-only | Only GET list=all (+ pagination). Response: 4 fields. 5000 req/month. |
| Summary profile | count, list, symbol, search, batch, filters. |
Authentication
Use either method on every request:
Authorization: Bearer YOUR_API_KEY?apikey=YOUR_API_KEY
List-only access
Only GET. One mode: list=all (legacy alias list=all_paidax). No filters.
| Item | Value |
|---|---|
| Params | list, start, length (max 100), lng, apikey |
| Response | 4 fields: Trading symbol, Shariah_verdict, report date, filing date |
| Monthly limit | 5000 requests |
| Forbidden | count, symbol, search, pool_status, filters, POST …/batch |
list=all
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 — list-only
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"
Summary profile access
Summary profile: verdict, income/debt ratios (%), activity, compliance — without raw
total_income / halal_income / haram_income amounts.
Exactly one main param per request:
count, list, symbol, search, pool, index, …
| Type | Allowed |
|---|---|
list= | all, availabledates, pool_status, index_status |
count= | all, country, sector, industry, exchange_short_name, verdict, new |
| Also | GET symbol, search, POST …/batch, filters |
| Forbidden | list=new, legacy list-only alias |
| Monthly limit | No fixed 5000/month — per-minute limit from group profile |
list=
list=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 }
}
}
list=all
https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&list=all&start=0&length=20
Returns Result.Symbols[] — summary profile per symbol (not the 4-field
Companies block from list-only access).
Example response
{
"Status": "OK",
"Message": "",
"Error_type": "",
"Result": {
"Symbols": [
{
"name": "1038",
"company_name": "CK Infrastructure Holdings Ltd",
"quarter": "FY",
"form": "10-K",
"period_report_date": "2025-12-31",
"filled_date": "2026-03-18",
"analysis_date": "2026-04-08T03:49:25.000Z",
"verdict_changed": "Yes",
"current_verdict": "Permissible",
"current_verdict_shariah_acceptance_date": "2026-04-08",
"risk_status_total_debt": "Green",
"risk_status_total_cashes_and_securities": "Green",
"previous_verdict": "Non permissible",
"previous_shariah_acceptance_date": "2025-10-06",
"halal_income_ratio": "97.26%",
"haram_income_ratio": "2.74%",
"total_debt_ratio": "16.84%",
"deposits_ratio": "7.25%",
"main_activity": "…",
"main_activity_status": "Halal",
"shariah_board_decision": "Halal",
"updated_at": "2026-04-03T06:17:11.881Z",
"updated_at_display": "03-04-2026",
"updated_days_ago": 91,
"report_published_date": "2026-03-18",
"report_published_date_display": "18-03-2026",
"compliance_status": "Shariah compliant",
"financial_report_year": "2025"
}
],
"Pagination": {
"total_count": 5028,
"start": 0,
"length": 20,
"current_page": 1,
"total_pages": 252,
"has_next": true,
"has_previous": false
},
"Applied_Filters": {},
"Sorting": { "field": "trading_symbol", "order": "asc" }
},
"counters": { "requests_current_month": 23, "total_requests": 28 }
}
list=availabledates
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=
count=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 }
]
}
}
symbol, search, POST batch
symbol=…
https://api.ailat.kz/api/v2/enterpriseunique?apikey=YOUR_API_KEY&symbol=1038
Same summary-profile fields as list=all (per symbol).
POST batch
POST https://api.ailat.kz/api/v2/enterpriseunique/batch
Request body:
{"symbols":["AAPL","MSFT"],"lng":"en"}
Example response:
{
"Status": "OK",
"Result": {
"Symbols": [
{ "trading_symbol": "AAPL", "shariah_verdict": "Permissible" },
{ "trading_symbol": "MSFT", "shariah_verdict": "Permissible" }
]
}
}
curl — summary profile
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"}'