---
title: "Get Account Controls"
method: GET
path: "/insights/v3/account-controls"
tags: ["Account Controls (New)"]
---

# Get Account Controls

`GET /insights/v3/account-controls`

Offers overview signals and configurable thresholds on a connected account,  returning a simple eligible/not-eligible verdict before any downstream process begins

## Query parameters

- `entity_id` string, uuid, required

## Response `200`

OK

- object
  - `insights` AccountControlsPayload — Insights payload wrapper carrying aggregated eligibility verdict for underwriting decisions
    - `account_controls` AccountControls, required — Account Controls assessment of a connected account: config-independent observable signals, configurable threshold-gate flags, and an aggregated eligibility verdict for underwriting decisions.
      - `signals` AccountControlsSignals, required — Config-independent observable facts about the account.
        - `account_age_months` integer, required — Months since the account was opened.
        - `is_current_account` boolean, required — Whether the account is a current account.
        - `has_salary_income` boolean, required — Whether salaried income was detected.
        - `has_non_salary_income` boolean, required — Whether non-salary income was detected.
        - `has_inflows` boolean, required — Whether any credit (inflow) transaction was detected.
        - `has_loan_repayments` boolean, required — Whether loan-repayment outflows were detected.
        - `has_loan_disbursements` boolean, required — Whether loan-disbursement inflows were detected.
        - `is_expense_account` boolean, required — Whether the account is used primarily for expenses.
      - `thresholds` AccountControlsThresholds, required — Result of evaluating each configurable gate. A null flag means the gate is not configured/enabled for this client and is excluded from the verdict.
        - `meets_minimum_average_salary` boolean, nullable, required — Detected average salary is greater than or equal to the configured minimum salary.
        - `meets_minimum_average_non_salary` boolean, nullable, required — Detected average non-salary income is greater than or equal to the configured minimum non-salary income.
        - `meets_minimum_account_age` boolean, nullable, required — account_age_months is greater than or equal to the configured minimum account age.
        - `meets_minimum_current_balance` boolean, nullable, required — Current balance is greater than or equal to the configured minimum current balance.
      - `verdict` AccountControlsVerdict, required — True only if all enabled thresholds pass
        - `eligible` boolean, required — True only if all enabled thresholds pass
  - `type` 'income' | 'employment' | 'cashflow' | 'credits-obligations' | 'non-credits-obligations' | 'expenses' | 'cash-balances' | 'freelancer-cashflow' | 'behaviors' | 'cashflow-patterns' | 'credit-assessments' | 'account-controls' | 'credit-obligations' — type of insight

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `408` — Request Timeout
- `500` — Internal Server Error

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)