Validation

Validate customers using BVNs, emails, or phone numbers. The validation APIs help you confirm the accuracy of customer information.

Bank Account Verification

POST Bank Account

POST https://adjutor.lendsqr.com/verification/bankaccount

This endpoint is used for verification of a bank account.

Headers

Request Body

{
   "status":"success",
   "message":"Successful",
   "data":{
      "bvn":"",
      "tier":null,
      "logo_url":"https://lendstack-s3.s3.us-east-2.amazonaws.com/bank_logos/057.png",
      "bank_code":"057",
      "account_name":"ADO JOHN SULE",
      "account_number":"1010118812"
   },
   "meta":{
      "balance":50000
   }
}

Karma Lookup

GET Karma

GET https://adjutor.lendsqr.com/verification/karma/0zspgifzbo.ga

This endpoint is used to search for the identity of a bad actor using identifying information such as phone number, email, domain name, BVN, card signature, and images.

Path Parameters

Headers

{
   "status":"success",
   "message":"Successful",
   "data":{
      "id":8,
      "karmaIdentity":"22212345678",
      "amountInContention":"1935710.23",
      "reason":null,
      "karmaType":{
         "karma":"Fraud"
      },
      "karmaIdentityType":{
         "identityType":"BVN"
      },
      "reportingEntity":{
         "name":"Some random lender limited",
         "email":"random@lender.com"
      }
   },
   "meta":{
      "cost":10,
      "balance":50000
   }
}

Ecosystem Lookup

GET Ecosystem

GET https://adjutor.lendsqr.com/verification/ecosystem/{{bvn}}

Confirm users' credit history and behaviour across the Lendsqr ecosystem

Path Parameters

Headers

{
    "status": "success",
    "message": "Successful",
    "data": {
        "bvn": "",
        "first_name": "Ado",
        "last_name": "John-Sule",
        "bvn_phone_number": "08012345678",
        "date_of_birth": "1990-09-08",
        "age": 30,
        "unique_phone_numbers": 1,
        "phone_number": "08012345678",
        "unique_emails": 1,
        "email": "adojohnsule@lendsqr.com",
        "lenders": 1,
        "first_account": "2020-09-22",
        "last_account": "2020-09-22",
        "failed_selfie_bvn_check": 0,
        "lending_lenders": 0,
        "loans": 0,
        "loan_amount": 0,
        "settled_loans": 0,
        "settled_loan_amount": 0,
        "settled_loan_amount_paid": 0,
        "running_loans": 0,
        "running_loan_amount": 0,
        "past_due_loans": 0,
        "past_due_loan_amount": 0,
        "past_due_loan_amount_due": 0,
        "penalty": 0,
        "penalty_paid": 0,
        "delayed_paid_loans": 0,
        "delayed_paid_loan_amount": 0,
        "delayed_paid_loans_trials": 0,
        "delayed_paid_loans_avg": 0,
        "delayed_paid_loans_trials_max": 0,
        "delayed_paid_loans_trials_min": 0,
        "first_loan_date": null,
        "last_loan_date": null,
        "loan_requests": 5,
        "failed_loan_requests": 5,
        "logins": 0,
        "first_login": null,
        "last_login": null,
        "unique_login_ips": 0,
        "unique_device_ids": 0,
        "distinct_mobile_os": 0,
        "processed_on": "2021-07-29T01:00:01.000Z"
    },
    "meta": {
        "cost": 15,
        "balance": 50000
    }
}

Last updated