Get started with SacComply

Prerequisites

• A SACCO Manager account on SacComply Console
• A provisioned sk_live_... API key from /settings/api-keys
• Your Core Banking or ERP database (Bankers Realm, CoreTec, Streamline, or custom database)

Call the API

1. 1
   Set your API key

   Export your API key as an environment variable or pass it directly in your HTTP client.

   export SACCOMPLY_API_KEY="sk_live_9f8e4b7a1c3d5e2f..."
2. 2
   Prepare project & dependencies

   Verify cURL is available on your terminal or server:

   curl --version
3. 3
   Push monthly return payload

   Submit balance sheet figures to /api/v1/ingest/monthly-return to trigger SASRA ratio calculations:

   quickstart.shCopy

   curl -X POST https://api.saccomply.co.ke/api/v1/ingest/monthly-return \
     -H "Authorization: Bearer $SACCOMPLY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "period": "2026-08-01",
       "total_assets": 690000000,
       "core_capital": 70000000,
       "total_deposits": 160000000,
       "short_term_liabilities": 12000000,
       "gross_loans": 410000000,
       "npl_amount": 39000000,
       "liquid_assets": 20000000
     }'

4. 4
   Inspect real-time SASRA compliance output

   Query GET /api/v1/status to receive instant prudential ratio evaluations:

   Output (JSON)Copy

   {
     "success": true,
     "period": "2026-08-01",
     "overall_status": "compliant",
     "ratios": [
       { "ratio_type": "capital_adequacy", "value": 10.14, "threshold": 10.0, "status": "green" },
       { "ratio_type": "liquidity", "value": 16.67, "threshold": 15.0, "status": "green" },
       { "ratio_type": "core_capital_to_deposits", "value": 43.75, "threshold": 8.0, "status": "green" },
       { "ratio_type": "npl_ratio", "value": 9.51, "threshold": 5.0, "status": "amber" }
     ],
     "open_risk_flags": { "critical": 0, "high": 0, "medium": 1, "low": 0 }
   }