API Documentation

Batch Enterprise API reference for the latest-per-symbol snapshot endpoint.

POST /api/v2/enterpriseunique/batch

Returns the latest enterprise snapshot for multiple ticker symbols in a single request.

Authentication: Bearer API key with Enterprise access.

Request Headers

Header	Value	Required
Authorization	`Bearer <api_key>`	Yes
Content-Type	`application/json`	Yes

Request Body

Field	Required	Description
symbols	Yes	Array of ticker symbols. Maximum 50 items.
lng	No	Optional language: en, ru, or kk. Unsupported values default to en.

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

Behavior Notes

Maximum 50 symbols per request.
Symbols are trimmed, normalized to uppercase, and deduplicated in first-occurrence order.
The response order follows the normalized input order.
Missing symbols do not fail the request and are reported in meta.not_found_symbols.
The Result payload uses the same canonical summary profile as list=pool_status, list=all, search, list=index_status, symbol, symbolhistory, and index=true.

Response Example: Full Success

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": [
    {
      "name": "AAPL",
      "company_name": "Apple Inc.",
      "verdict_changed": "No",
      "current_verdict": "Permissible",
      "current_verdict_shariah_acceptance_date": "2025-12-31",
      "risk_status_total_debt": "Green",
      "risk_status_total_cashes_and_securities": "Green",
      "previous_verdict": "Permissible",
      "previous_shariah_acceptance_date": "2025-09-30",
      "halal_income_ratio": "96.20%",
      "haram_income_ratio": "3.80%",
      "total_debt_ratio": "12.45%",
      "deposits_ratio": "4.90%",
      "main_activity": "Consumer electronics",
      "main_activity_status": "Halal",
      "shariah_board_decision": "Halal",
      "shariah_board_decision_text": "Permissible after review of income composition.",
      "updated_at": "2026-06-22T10:30:00.000Z",
      "updated_at_display": "22-06-2026",
      "updated_days_ago": 1,
      "report_published_date": "2025-12-31",
      "report_published_date_display": "31-12-2025",
      "compliance_status": "Shariah compliant",
      "financial_report_year": "2025"
    },
    {
      "name": "MSFT",
      "company_name": "Microsoft Corporation",
      "verdict_changed": "No",
      "current_verdict": "Permissible",
      "current_verdict_shariah_acceptance_date": "2025-12-31",
      "risk_status_total_debt": "Green",
      "risk_status_total_cashes_and_securities": "Yellow",
      "previous_verdict": "Permissible",
      "previous_shariah_acceptance_date": "2025-09-30",
      "halal_income_ratio": "96.20%",
      "haram_income_ratio": "3.80%",
      "total_debt_ratio": "12.45%",
      "deposits_ratio": "4.90%",
      "main_activity": "Consumer electronics",
      "main_activity_status": "Halal",
      "shariah_board_decision": "Halal",
      "shariah_board_decision_text": "Permissible after review of income composition.",
      "updated_at": "2026-06-22T10:30:00.000Z",
      "updated_at_display": "22-06-2026",
      "updated_days_ago": 1,
      "report_published_date": "2025-12-31",
      "report_published_date_display": "31-12-2025",
      "compliance_status": "Shariah compliant",
      "financial_report_year": "2025"
    }
  ],
  "meta": {
    "requested_symbols": 2,
    "normalized_symbols": [
      "AAPL",
      "MSFT"
    ],
    "found_symbols": 2,
    "not_found_symbols": []
  },
  "time": {
    "Current_date": "2026-06-22 10:30:00"
  },
  "counters": {
    "requests_current_minute": 5
  }
}

Response Example: Partial Success

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": [
    {
      "name": "AAPL",
      "company_name": "Apple Inc.",
      "verdict_changed": "No",
      "current_verdict": "Permissible",
      "current_verdict_shariah_acceptance_date": "2025-12-31",
      "risk_status_total_debt": "Green",
      "risk_status_total_cashes_and_securities": "Green",
      "previous_verdict": "Permissible",
      "previous_shariah_acceptance_date": "2025-09-30",
      "halal_income_ratio": "96.20%",
      "haram_income_ratio": "3.80%",
      "total_debt_ratio": "12.45%",
      "deposits_ratio": "4.90%",
      "main_activity": "Consumer electronics",
      "main_activity_status": "Halal",
      "shariah_board_decision": "Halal",
      "shariah_board_decision_text": "Permissible after review of income composition.",
      "updated_at": "2026-06-22T10:30:00.000Z",
      "updated_at_display": "22-06-2026",
      "updated_days_ago": 1,
      "report_published_date": "2025-12-31",
      "report_published_date_display": "31-12-2025",
      "compliance_status": "Shariah compliant",
      "financial_report_year": "2025"
    },
    {
      "name": "MSFT",
      "company_name": "Microsoft Corporation",
      "verdict_changed": "No",
      "current_verdict": "Permissible",
      "current_verdict_shariah_acceptance_date": "2025-12-31",
      "risk_status_total_debt": "Green",
      "risk_status_total_cashes_and_securities": "Yellow",
      "previous_verdict": "Permissible",
      "previous_shariah_acceptance_date": "2025-09-30",
      "halal_income_ratio": "96.20%",
      "haram_income_ratio": "3.80%",
      "total_debt_ratio": "12.45%",
      "deposits_ratio": "4.90%",
      "main_activity": "Consumer electronics",
      "main_activity_status": "Halal",
      "shariah_board_decision": "Halal",
      "shariah_board_decision_text": "Permissible after review of income composition.",
      "updated_at": "2026-06-22T10:30:00.000Z",
      "updated_at_display": "22-06-2026",
      "updated_days_ago": 1,
      "report_published_date": "2025-12-31",
      "report_published_date_display": "31-12-2025",
      "compliance_status": "Shariah compliant",
      "financial_report_year": "2025"
    }
  ],
  "meta": {
    "requested_symbols": 3,
    "normalized_symbols": [
      "AAPL",
      "MSFT",
      "TSLA"
    ],
    "found_symbols": 2,
    "not_found_symbols": [
      "TSLA"
    ]
  },
  "time": {
    "Current_date": "2026-06-22 10:30:00"
  },
  "counters": {
    "requests_current_minute": 5
  }
}

Error Behavior

200 OK for full success, partial success, or valid requests with no matches.
400 Bad Request for invalid JSON body structure.
401 Unauthorized for invalid or missing API key.
403 Forbidden for missing Enterprise access, invalid subscription, or rate limiting.

GET /api/v2/enterpriseunique/?list=pool_status

Returns the current pool-status snapshot for the authenticated Enterprise user pool.

Authentication: Bearer API key with Enterprise access.

Pagination

Pagination parameters for controlling result sets.

start: Starting position, 0-based offset.
length: Number of records per page.

{
  "url": "{{publicBaseUrl}}/api/v2/enterpriseunique/?list=pool_status&start=10&length=20",
  "authorization": "Bearer YOUR_API_KEY"
}

Query Parameters

Field	Required	Description
list	Yes	Must be pool_status for public/external usage.
start	No	Starting position, 0-based offset. Use 0, 50, 100, 150, ... for batch export.
length	No	Number of records per page. Use 50 for export batches. Maximum 100.
sort_field	No	Sorting field for pool_status results. Example: market_cap.
sort_order	No	Sorting direction. Use asc or desc.

Request Example

{
  "url": "https://api.ailat.kz/api/v2/enterpriseunique/?list=pool_status&start=0&length=50",
  "authorization": "Bearer YOUR_API_KEY"
}

Sorting

Allow sorting on pool_status results. sort_order is asc or desc.

{
  "url": "https://api.ailat.kz/api/v2/enterpriseunique/?list=pool_status&sort_field=market_cap&sort_order=desc",
  "authorization": "Bearer YOUR_API_KEY"
}

Behavior Notes

External users should use only list=pool_status.
The same summary-profile field set now also applies to list=all, search, list=index_status, symbol, symbolhistory, index=true, and the batch endpoint.
For targeted export in chunks of 50, request start=0&length=50, then start=50&length=50, then start=100&length=50, and continue until Symbols becomes empty or shorter than 50.
start is the offset, and length is the page size.

Response Example

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": {
    "Symbols": [
      {
        "name": "AAPL",
        "company_name": "Apple Inc.",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Green",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "96.20%",
        "haram_income_ratio": "3.80%",
        "total_debt_ratio": "12.45%",
        "deposits_ratio": "4.90%",
        "main_activity": "Consumer electronics",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      },
      {
        "name": "MSFT",
        "company_name": "Microsoft Corporation",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Yellow",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "95.00%",
        "haram_income_ratio": "5.00%",
        "total_debt_ratio": "11.20%",
        "deposits_ratio": "6.40%",
        "main_activity": "Software",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      }
    ]
  },
  "time": {
    "Current_date": "2026-06-22 10:30:00"
  },
  "counters": {
    "requests_current_minute": 5
  }
}

Error Behavior

200 OK for successful requests.
401 Unauthorized for invalid or missing API key.
403 Forbidden for missing Enterprise access, invalid subscription, or rate limiting.

GET /api/v2/enterpriseunique/?list=all

Returns paginated enterprise discovery results using the same summary-profile symbol fields as pool_status.

Authentication: Bearer API key with Enterprise access.

Query Parameters

Field	Required	Description
list	Yes	Set to all to retrieve the paginated enterprise catalog.
start	No	Starting position, 0-based offset.
length	No	Number of records per page. Example uses 50.

Request Example

{
  "url": "{{publicBaseUrl}}/api/v2/enterpriseunique/?list=all&start=0&length=50",
  "authorization": "Bearer YOUR_API_KEY"
}

Behavior Notes

list=all now returns the same summary-profile symbol fields as list=pool_status.
The envelope still includes Pagination, Applied_Filters, and Sorting.
Use start=0&length=50 for the first page, then increment start by 50 for the next page.

Response Example

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": {
    "Symbols": [
      {
        "name": "AAPL",
        "company_name": "Apple Inc.",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Green",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "96.20%",
        "haram_income_ratio": "3.80%",
        "total_debt_ratio": "12.45%",
        "deposits_ratio": "4.90%",
        "main_activity": "Consumer electronics",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      },
      {
        "name": "MSFT",
        "company_name": "Microsoft Corporation",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Yellow",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "95.00%",
        "haram_income_ratio": "5.00%",
        "total_debt_ratio": "11.20%",
        "deposits_ratio": "6.40%",
        "main_activity": "Software",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      }
    ],
    "Pagination": {
      "total_count": 3210,
      "start": 0,
      "length": 50,
      "current_page": 1,
      "total_pages": 65,
      "has_next": true,
      "has_previous": false
    },
    "Applied_Filters": {},
    "Sorting": {
      "field": "market_cap",
      "order": "desc"
    }
  },
  "time": {
    "Current_date": "2026-06-22 10:30:00"
  },
  "counters": {
    "requests_current_minute": 5
  }
}

Error Behavior

200 OK for successful requests.
401 Unauthorized for invalid or missing API key.
403 Forbidden for missing Enterprise access, invalid subscription, or rate limiting.

List Mode Examples

Focused request and response snippets for the main Enterprise list modes.

GET List: pool_status

Returns the current pool snapshot for the authenticated Enterprise user using the canonical summary-profile fields.

Authentication: Bearer API key with Enterprise access.

Request Example

{
  "url": "{{publicBaseUrl}}/api/v2/enterpriseunique/?list=pool_status&start=0&length=50",
  "authorization": "Bearer YOUR_API_KEY"
}

Behavior Notes

Supports start/length pagination and sort_field/sort_order sorting.
Uses the shared snake_case summary-profile payload.

Response Example

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": {
    "Symbols": [
      {
        "name": "AAPL",
        "company_name": "Apple Inc.",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Green",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "96.20%",
        "haram_income_ratio": "3.80%",
        "total_debt_ratio": "12.45%",
        "deposits_ratio": "4.90%",
        "main_activity": "Consumer electronics",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      },
      {
        "name": "MSFT",
        "company_name": "Microsoft Corporation",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Yellow",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "95.00%",
        "haram_income_ratio": "5.00%",
        "total_debt_ratio": "11.20%",
        "deposits_ratio": "6.40%",
        "main_activity": "Software",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      }
    ]
  }
}

GET List: availabledates

Returns the distinct available report dates for one trading symbol.

Authentication: Bearer API key with Enterprise access.

Request Example

{
  "url": "{{publicBaseUrl}}/api/v2/enterpriseunique/?list=availabledates&trading_symbol=AAPL&start=0&length=10",
  "authorization": "Bearer YOUR_API_KEY"
}

Behavior Notes

Requires trading_symbol.
Returns normalized YYYY-MM-DD dates.

Response Example

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": {
    "trading_symbol": "AAPL",
    "AvailableDates": [
      "2025-12-31",
      "2025-09-30",
      "2025-06-30"
    ],
    "Pagination": {
      "total_count": 3,
      "start": 0,
      "length": 10,
      "current_page": 1,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    }
  }
}

GET List: new

Returns recent Enterprise records from the latest 30-day window using the legacy compact list payload.

Authentication: Bearer API key with Enterprise access.

Request Example

{
  "url": "{{publicBaseUrl}}/api/v2/enterpriseunique/?list=new&start=0&length=10",
  "authorization": "Bearer YOUR_API_KEY"
}

Behavior Notes

Default list=new output uses the legacy compact list payload, not the summary-profile payload.
Only verdict filtering is allowed on this list mode.

Response Example

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": {
    "Symbols": [
      {
        "trading_symbol": "AAPL",
        "company_name": "Apple Inc.",
        "sector": "Technology",
        "industry": "Consumer Electronics",
        "country": "USA",
        "exchange_short_name": "NASDAQ",
        "shariah_verdict": "Permissible",
        "verdict_description": {
          "Verdicts": {
            "Final": {
              "Acceptance by Islam": "Permissible"
            }
          }
        },
        "market_cap": 3100000000000,
        "market_cap_24": 3050000000000,
        "total_debt": 110000000000,
        "total_cash_and_securities": 49000000000,
        "ratio_total_debt_to_market_cap_24": 0.0361,
        "ratio_cash_and_securities_to_market_cap_24": 0.0161,
        "total_income": 120000000000,
        "halal_income": 115440000000,
        "haram_income": 4560000000,
        "total_income_description": "Latest annual income review.",
        "halal_income_description": "Permissible after review of income composition.",
        "haram_income_description": "Non-core non-permissible income remained below threshold.",
        "ratio_halal_income_to_total_income": 0.962,
        "ratio_haram_income_to_total_income": 0.038,
        "period_report_date": "20251231",
        "filled_date": "2025-12-31",
        "accept_date": "2026-01-05"
      }
    ],
    "Pagination": {
      "total_count": 1,
      "start": 0,
      "length": 10,
      "current_page": 1,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "Applied_Filters": {},
    "Sorting": {
      "field": "period_report_date",
      "order": "desc"
    }
  }
}

GET List: index_status

Returns the current index snapshot for the authenticated Enterprise user using the canonical summary-profile fields.

Authentication: Bearer API key with Enterprise access.

Request Example

{
  "url": "{{publicBaseUrl}}/api/v2/enterpriseunique/?list=index_status&start=0&length=50",
  "authorization": "Bearer YOUR_API_KEY"
}

Behavior Notes

Uses the user profile index_list as the source set.
Uses the shared snake_case summary-profile payload.

Response Example

{
  "Status": "OK",
  "Message": "",
  "Error_type": "",
  "Result": {
    "Symbols": [
      {
        "name": "AAPL",
        "company_name": "Apple Inc.",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Green",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "96.20%",
        "haram_income_ratio": "3.80%",
        "total_debt_ratio": "12.45%",
        "deposits_ratio": "4.90%",
        "main_activity": "Consumer electronics",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      },
      {
        "name": "MSFT",
        "company_name": "Microsoft Corporation",
        "verdict_changed": "No",
        "current_verdict": "Permissible",
        "current_verdict_shariah_acceptance_date": "2025-12-31",
        "risk_status_total_debt": "Green",
        "risk_status_total_cashes_and_securities": "Yellow",
        "previous_verdict": "Permissible",
        "previous_shariah_acceptance_date": "2025-09-30",
        "halal_income_ratio": "95.00%",
        "haram_income_ratio": "5.00%",
        "total_debt_ratio": "11.20%",
        "deposits_ratio": "6.40%",
        "main_activity": "Software",
        "main_activity_status": "Halal",
        "shariah_board_decision": "Halal",
        "shariah_board_decision_text": "Permissible after review of income composition.",
        "updated_at": "2026-06-22T10:30:00.000Z",
        "updated_at_display": "22-06-2026",
        "updated_days_ago": 1,
        "report_published_date": "2025-12-31",
        "report_published_date_display": "31-12-2025",
        "compliance_status": "Shariah compliant",
        "financial_report_year": "2025"
      }
    ]
  }
}