Credit Assessments (NEW)

Get Credit Assessments

Aggregates income, expenses, and balance into pre-computed credit indicators for DBR, affordability ratio, net cashflow, and max installment capacity. This endpoint offers configuration capabilities in order to fit and calibrate to your credit policy.

get/insights/v3/credit-assessments

Request

  • Base URL
    https://sandbox.leantech.me
  • URL
    https://sandbox.leantech.me/insights/v3/credit-assessments
  • Auth
    HTTP bearer

Query parameters

entity_idstring uuid required

The entity_id you're querying for.

start_datestring date

The start date in UTC (in the format YYYY-MM-DD) of the analysis window. When omitted, defaults to the earliest transaction available for the entity.

end_datestring date

The end date in UTC (in the format YYYY-MM-DD) of the analysis window (inclusive — transactions on this date are included). When omitted, defaults to the current time.

Response

OK

status'OK' | 'PENDING' | 'FAILED' | 'CONSENT_EXPIRED' | 'RECONNECT_REQUIRED' | 'PROCESSING_STARTED' required

The status of the request

results_idstring uuid required

The unique identifier for the request

messagestring required

A message describing the status of the request

metaobject nullable

Meta information about the request

timestampstring date-time required

The datetime of when the request was made

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

Example response

{
  "insights": {
    "credit_assessments": {
      "income": {
        "employment_income": {
          "breakdown": [
            {
              "total_amount": {
                "currency": "AED"
              },
              "average_monthly_amount": {
                "currency": "AED"
              },
              "minimum_monthly_amount": {
                "currency": "AED"
              },
              "maximum_monthly_amount": {
                "currency": "AED"
              },
              "contributed_monthly_income": {
                "currency": "AED"
              }
            }
          ]
        },
        "other_income": {
          "breakdown": [
            {
              "total_amount": {
                "currency": "AED"
              },
              "average_monthly_amount": {
                "currency": "AED"
              },
              "minimum_monthly_amount": {
                "currency": "AED"
              },
              "maximum_monthly_amount": {
                "currency": "AED"
              },
              "contributed_monthly_income": {
                "currency": "AED"
              }
            }
          ]
        },
        "total_contributed_monthly_income": {
          "currency": "AED"
        }
      },
      "expenses": {
        "average_monthly_credit_repayments": {
          "currency": "AED"
        },
        "average_monthly_essential_expenses": {
          "currency": "AED"
        },
        "average_monthly_discretionary_expenses": {
          "currency": "AED"
        },
        "average_monthly_total_expenses": {
          "currency": "AED"
        }
      },
      "balance": {
        "average_balance": {
          "currency": "AED"
        },
        "minimum_balance": {
          "currency": "AED"
        },
        "maximum_balance": {
          "currency": "AED"
        }
      },
      "computed_indicators": {
        "average_monthly_net_cashflow": {
          "currency": "AED"
        },
        "dbr": {
          "maximum_monthly_installment": {
            "currency": "AED"
          }
        },
        "affordability": {
          "maximum_monthly_installment": {
            "currency": "AED"
          }
        }
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.