Financial Monitoring

Deprecated
post

This endpoint assesses a user’s ability to afford a specified loan based on their actual financial data. It analyzes monthly income, expenses, savings, and debt obligations to determine whether the proposed loan is financially manageable

Required scopes
This endpoint requires the following scopes:
  • : Note: Data availability may vary depending on the financial institution, and access to certain data may be subject to intermittent connectivity issues from our transactions provider.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
task_idstring[]Optional

List of task IDs returned from the bank statement upload API call. Each task ID represents a specific upload request processed by the system.

interest_ratenumberRequired

Annual interest rate applied to the loan, expressed as a percentage (e.g., 10.5 for 10.5%). This value is required for affordability calculations.

loan_amountintegerRequired

Total principal amount of the loan being assessed for affordability, expressed in the relevant currency (e.g., ZAR).

loan_term_yearsnumberOptional

Duration of the loan term in years (e.g., 5 for a 5-year loan). Used to calculate repayment capacity.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
200Success
application/json
post
/api/bankstatement/affordability
Deprecated
post

Retrieve behavioral-risk scores based on the previously uploaded bank statement. USE AFTER (/api/bankstatement/upload).

Required scopes
This endpoint requires the following scopes:
  • : Note: Data availability may vary depending on the financial institution, and access to certain data may be subject to intermittent connectivity issues from our transactions provider.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
task_idstringOptional

task_id returned from the bank statement upload API call

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
200Success
application/json
post
/api/bankstatement/behavioral-risk
Deprecated
post

This API endpoint evaluates the liquidity risk of an entity based on its bank statements. It analyzes financial metrics such as net cash flow, average daily balance, cash flow volatility, and liquidity ratio to generate a liquidity score. The response includes a risk tier classification, an explanation of the score, and detailed financial metrics that influenced the assessment.

Required scopes
This endpoint requires the following scopes:
  • : Note: Data availability may vary depending on the financial institution, and access to certain data may be subject to intermittent connectivity issues from our transactions provider.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
task_idstring[]Optional

task_id returned from the bank statement upload API call

max_volatilitynumberOptional

Maximum allowable variation in cash flow. Default is 0.3 (30%). Lower values indicate a stricter requirement for stability, while higher values allow more fluctuation..

min_net_cash_flownumberOptional

The minimum net cash flow required to pass the evaluation. This sets a threshold for financial health.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
200Success
application/json
post
/api/bankstatement/liquidity
Deprecated
post

This API endpoint evaluates the financial risk of an entity based on bank statement data. It analyzes various financial metrics such as balance volatility, income stability, liquidity ratio, and overdraft frequency to generate a risk score. The response includes a risk tier classification, explanations for the score, and detailed financial metrics that influenced the assessment.

Required scopes
This endpoint requires the following scopes:
  • : Note: Data availability may vary depending on the financial institution, and access to certain data may be subject to intermittent connectivity issues from our transactions provider.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
task_idstring[]Optional

List of task IDs returned from the bank statement upload API call. Each task ID represents a specific upload request processed by the system.

min_avg_balancenumberOptional

Minimum average account balance. Default: 5000. Ensures users maintain enough cash reserves over time.

min_income_stabilitynumberOptional

Required income stability level. Default: 0.8 (or 80%). Income should not vary by more than 20% to qualify.

max_overdraft_freqnumberOptional

Maximum percentage of transactions that can go into overdraft. Default: 0.05 (5%). Lower values = better money management.

min_expense_coveragenumberOptional

Minimum ratio of income to expenses. Default: 1.5. This means income must be at least 1.5× more than expenses to pass.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
200Success
application/json
post
/api/bankstatement/risk
Deprecated
post

Retrieve bank statement transactions based on the previously uploaded bank statement. USE AFTER (/api/bankstatement/upload)

Required scopes
This endpoint requires the following scopes:
  • : Note: Data availability may vary depending on the financial institution, and access to certain data may be subject to intermittent connectivity issues from our transactions provider.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body
task_idstringOptional

task_id returned from the bank statement upload API call

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses
200Success
application/json
post
/api/bankstatement/transactions
Deprecated
post

Upload a bank statement to initiate risk analysis and scoring, the first step in assessing financial health.

Required scopes
This endpoint requires the following scopes:
  • : Note: Data availability may vary depending on the financial institution, and access to certain data may be subject to intermittent connectivity issues from our transactions provider.
Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:
Body

Payload for uploading an bank statement for analysis and verification.

base_64_pdfstringOptional

The bank statement document, encoded as a Base64 string. The file must be a valid PDF.

client_typenumberOptional

Specifies the type of client entity. Use 1 if an ID number (individual) is provided, or 2 if a company registration number is provided.

company_regstringOptional

Company registration number. Required only if the bank statement belongs to a registered business entity.

id_numberstringOptional

South African ID number. Required only if the bank statement belongs to an individual rather than a company.

bank_namestringOptional

The name of the financial institution. Supported Banks: 'ABSA', 'Nedbank', 'FNB', Standard bank', and 'Capitec bank'.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us.

Responses
200Success
application/json
post
/api/bankstatement/upload

Last updated