Business Loan Fraud Check - Adhere by Smartcomply

POST

api

loan

fraud_check

Loan Fraud Check

curl --request POST \
  --url https://adhere-api.smartcomply.com/api/v1/loan/fraud_check/ \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-access-token: <api-key>' \
  --form loan_amount_requested=100000 \
  --form loan_repayment_duration_value=6 \
  --form collateral_required=false \
  --form 'first_name=<string>' \
  --form 'last_name=<string>' \
  --form 'business_name=<string>' \
  --form 'rc_number=<string>' \
  --form date_of_birth=2023-12-25 \
  --form country=Nigeria \
  --form 'current_address=<string>' \
  --form 'business_address=<string>' \
  --form identification_type=Passport \
  --form 'identification_number=<string>' \
  --form 'bvn=<string>' \
  --form 'phone_number=<string>' \
  --form email_address=jsmith@example.com \
  --form 'employment_type=<string>' \
  --form 'job_role=<string>' \
  --form 'employer_name=<string>' \
  --form annual_income=123 \
  --form annual_revenue=123 \
  --form 'employment_duration=<string>' \
  --form 'bank_name=<string>' \
  --form 'account_number=<string>' \
  --form 'purpose_of_loan=<string>' \
  --form 'collateral=<string>' \
  --form is_individual=true \
  --form is_business=true \
  --form run_aml_check=false

{
  "status": "failed",
  "data": [
    "<unknown>"
  ],
  "message": "<string>"
}

The Business Loan Fraud Check endpoint evaluates a loan application from a business entity, combining submitted company information with credit bureau data to produce a fraud risk score and financial analysis.

Endpoint

POST /api/v1/loan/fraud_check/

Request

Headers

Header	Value	Required
`x-access-token`	Your API secret key	Yes
`Content-Type`	`multipart/form-data`	Yes

Body Parameters

Parameter	Type	Required	Description
`business_name`	string	Yes	Registered name of the business
`business_address`	string	Yes	Business address
`rc_number`	string	Yes	CAC registration number (e.g., `RC-123456`)
`city`	string	Yes	City of the business
`country`	string	Yes	Country of the business
`phone_number`	string	Yes	Business phone number
`email_address`	string	Yes	Business email address
`identification_type`	string	Yes	ID type used (e.g., `Passport`, `RC Number`)
`identification_number`	string	Yes	ID number
`annual_revenue`	number	Yes	Annual revenue in local currency
`bank_name`	string	Yes	Business bank name
`account_number`	string	Yes	Business account number
`loan_amount_requested`	number	Yes	Requested loan amount
`purpose_of_loan`	string	No	Purpose of the loan
`loan_repayment_duration_type`	string	Yes	Repayment period unit: `weeks`, `months`, or `years`
`loan_repayment_duration_value`	integer	Yes	Number of repayment periods
`collateral_required`	boolean	Yes	Whether collateral is being offered
`is_business`	boolean	Yes	Must be `true` for business checks
`run_aml_check`	boolean	No	Run an AML check. Defaults to `false`

Example

curl -X POST "https://adhere-api.smartcomply.com/api/v1/loan/fraud_check/" \
  -H "x-access-token: YOUR_SECRET_KEY" \
  -F "business_name=Heineken" \
  -F "business_address=23 Main Street, Marina" \
  -F "rc_number=RC-123456" \
  -F "city=Lagos" \
  -F "country=Nigeria" \
  -F "phone_number=2349012345678" \
  -F "email_address=business@example.com" \
  -F "identification_type=RC Number" \
  -F "identification_number=RC-123456" \
  -F "annual_revenue=12345678" \
  -F "bank_name=Access Bank" \
  -F "account_number=1234567890" \
  -F "loan_amount_requested=1000000" \
  -F "loan_repayment_duration_type=months" \
  -F "loan_repayment_duration_value=5" \
  -F "collateral_required=false" \
  -F "is_business=true" \
  -F "run_aml_check=false"

Response

200 OK

Field	Type	Description
`data.id`	number	Internal record ID
`data.business_name`	string	Business name from the application
`data.fraud_risk_score`	number	Overall fraud risk score (0–100; higher = greater risk)
`data.recommendation`	string	Narrative assessment and guidance for loan decision
`data.key_financial_analysis.income_stability`	object	Revenue stability with disposable income ratio
`data.key_financial_analysis.repayment_duration`	object	Repayment timeline assessment
`data.key_financial_analysis.collateral_coverage`	object	Loan-to-collateral ratio
`data.key_financial_analysis.debt_serviceability`	object	Ability to service debt from revenue
`data.key_financial_analysis.debt_to_income_ratio`	object	Debt service ratio vs the 40% threshold
`data.history`	object	Credit history: total loans, delinquencies, outstanding amounts
`data.status`	string	Processing status (e.g., `reviewed`)

{
  "status": "Success",
  "data": {
    "id": 567,
    "business_name": "Heineken",
    "country": "Nigeria",
    "city": "Lagos",
    "business_address": "23 Main Street, Apapa",
    "identification_type": "RC Number",
    "rc_number": "RC-123456",
    "phone_number": "2349012345678",
    "annual_revenue": "12345678.00",
    "loan_amount_requested": 1000000.00,
    "purpose_of_loan": "Business Expansion",
    "fraud_risk_score": 62,
    "recommendation": "The applicant is requesting a loan of ₦1,000,000.00. The applicant's total fraud risk score is 62, which needs to be evaluated against the lender's risk threshold.",
    "key_financial_analysis": {
      "income_stability": {
        "risk_score": 100,
        "data_source": "submitted data (estimated)",
        "monthly_income": "1028806.50",
        "monthly_expenses": "925925.85",
        "disposable_income": "102880.65",
        "observation": "Disposable ratio of 10% indicates limited buffer for unexpected expenses."
      },
      "repayment_duration": {
        "risk_score": 70,
        "repayment_duration": "Within 5 months"
      },
      "collateral_coverage": {
        "risk_score": 80,
        "loan_amount": "1000000.00",
        "collateral_value": "0.00",
        "loan_to_collateral_ratio": "0.00%",
        "observation": "The loan is entirely unsecured."
      },
      "debt_serviceability": {
        "risk_score": 30,
        "loan_amount": "1000000.00",
        "total_repayment": "1040000.0000",
        "observation": "Monthly repayment constitutes ~20% of monthly income, indicating manageable serviceability."
      },
      "debt_to_income_ratio": {
        "risk_score": 30,
        "debt_service_ratio": "20.22%",
        "observation": "Debt Service Ratio is below the 40% threshold, indicating low debt burden."
      }
    },
    "history": {
      "totalOverdue": 54931635,
      "totalBorrowed": 135582,
      "totalNoOfLoans": 9,
      "totalOutstanding": 54931635,
      "highestLoanAmount": 45194,
      "totalNoOfActiveLoans": 3,
      "totalNoOfClosedLoans": 6,
      "totalNoOfInstitutions": 2,
      "totalNoOfPerformingLoans": 6,
      "totalNoOfDelinquentFacilities": 3
    },
    "is_individual": false,
    "is_business": true,
    "status": "reviewed",
    "date_created": "2025-03-28T02:42:23.815369Z"
  },
  "message": "Loan fraud check processed successfully"
}

400 Bad Request

{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}

401 Unauthorized

{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}

Authorizations

x-access-token

string

header

required

Your Adhere API secret key

Body

multipart/form-data

loan_amount_requested

number

required

Example:

100000

loan_repayment_duration_type

enum<string>

required

Available options:

weeks,

months,

years

loan_repayment_duration_value

integer

required

Example:

6

collateral_required

boolean

default:false

required

first_name

string

Individual applicant first name

last_name

string

business_name

string

Business name (business applications only)

rc_number

string

CAC registration number (business only)

date_of_birth

string<date>

gender

enum<string>

Available options:

male,

female

country

string

Example:

"Nigeria"

current_address

string

business_address

string

identification_type

string

Example:

"Passport"

identification_number

string

bvn

string

phone_number

string

email_address

string<email>

employment_type

string

job_role

string

employer_name

string

annual_income

number

annual_revenue

number

Annual revenue (business only)

employment_duration

string

bank_name

string

account_number

string

purpose_of_loan

string

collateral

string

is_individual

boolean

Set true for individual applications

is_business

boolean

Set true for business applications

run_aml_check

boolean

default:false

Response

Loan fraud check processed

Individual Loan Fraud Check

Loan Fraud Check

curl --request POST \
  --url https://adhere-api.smartcomply.com/api/v1/loan/fraud_check/ \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-access-token: <api-key>' \
  --form loan_amount_requested=100000 \
  --form loan_repayment_duration_value=6 \
  --form collateral_required=false \
  --form 'first_name=<string>' \
  --form 'last_name=<string>' \
  --form 'business_name=<string>' \
  --form 'rc_number=<string>' \
  --form date_of_birth=2023-12-25 \
  --form country=Nigeria \
  --form 'current_address=<string>' \
  --form 'business_address=<string>' \
  --form identification_type=Passport \
  --form 'identification_number=<string>' \
  --form 'bvn=<string>' \
  --form 'phone_number=<string>' \
  --form email_address=jsmith@example.com \
  --form 'employment_type=<string>' \
  --form 'job_role=<string>' \
  --form 'employer_name=<string>' \
  --form annual_income=123 \
  --form annual_revenue=123 \
  --form 'employment_duration=<string>' \
  --form 'bank_name=<string>' \
  --form 'account_number=<string>' \
  --form 'purpose_of_loan=<string>' \
  --form 'collateral=<string>' \
  --form is_individual=true \
  --form is_business=true \
  --form run_aml_check=false

{
  "status": "failed",
  "data": [
    "<unknown>"
  ],
  "message": "<string>"
}

Documentation Index

​Endpoint

​Request

​Headers

​Body Parameters

​Example

​Response

​200 OK

​400 Bad Request

​401 Unauthorized

Authorizations

Body

Response

Endpoint

Request

Headers

Body Parameters

Example

Response

200 OK

400 Bad Request

401 Unauthorized