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

# Get Account Controls

`GET /insights/v3/account-controls`

## Request

- Base URL: `https://sandbox.leantech.me`
- URL: `https://sandbox.leantech.me/insights/v3/account-controls`
- Auth: HTTP bearer

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
  - `status` 'OK' | 'PENDING' | 'FAILED' | 'CONSENT_EXPIRED' | 'RECONNECT_REQUIRED' | 'PROCESSING_STARTED', required: The status of the request
  - `results_id` string, uuid, required: The unique identifier for the request
  - `message` string, required: A message describing the status of the request
  - `meta` object, nullable: Meta information about the request
  - `timestamp` string, date-time, required: The datetime of when the request was made
  - `status_detail` StatusDetail, nullable
    - `granular_status_code` string, nullable: Granular status code
    - `status_additional_info` string, nullable: Additional information about the status
  - `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.
        - `has_self_transfers` boolean, required: Whether the self transfer is detected for the connected accounts
        - `self_transfer_sources` SelfTransferSource[], required: Detected self transfers between connected accounts. Empty when no self transfer was detected.
          - `iban` string, nullable: The IBAN of the counterparty account. Null when the IBAN could not be resolved from the transaction.
          - `bank_identifier` string, nullable, required: The Lean identifier for the counterparty bank. Null when the bank could not be resolved from the transaction.
      - `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' | 'cashflow-patterns' | 'credit-assessments' | 'account-controls' | 'credit-obligations' | 'spending': type of insight

## Other responses

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

---

[API](https://skmtc.dev/leantech/apis/insights-api-account-controls.md) - [All operations](https://skmtc.dev/leantech/apis/insights-api-account-controls/llms.txt) - [OpenAPI document](https://skmtc.dev/leantech/apis/insights-api-account-controls/revisions/6a904c24f1e4?raw)