​
Generate Business Credit History with First Central

Adhere’s Business Credit History endpoint, powered by First Central, provides businesses with a comprehensive record of their credit-related activities, including credit accounts, payment timelines, credit utilization, account closures, and instances of delinquency. By using this endpoint, businesses can gain valuable insights into their credit behavior, assess their creditworthiness, and understand the factors shaping their credit standing for effective monitoring and management.

​
Request Endpoint

POST: {{BASE_URL}}/api/onboarding/business/first_central/

  • Media-Type: application/json

​
Status Codes

  • 200 OK: The request was successful, and the business’ credit information is returned successfully.
  • 400 Bad Request: The request could not be completed due to invalid or missing information.

​
Sample request

{
  "registration_number": "RC123456"
}

​
200 OK Response

{
  "success": true,
  "statusCode": 200,
  "message": "Business Credit History",
  "response_code": "00",
  "data": {
    "_id": "636e768d8215a2e2fb06cfde",
    "business_reg_no": "RC123456",
    "businessId": "64db7ab8a26e603218838892",
    "name": "CAPITALFIELD ASSET MGT LTD",
    "phone": "23408036732620",
    "dateOfRegistration": "2003-08-20",
    "address": "ELEGANZA HOUSE,15B JOSEPH WESLEY STR.BROAD STREET   025 NG   LAGOS NIGERIA ",
    "website": "",
    "taxIdentificationNumber": "",
    "noOfDirectors": 0,
    "industry": "",
    "businessType": "SMALLANDMEDIUMSCALEENTERPRISE",
    "email": "capitalasset@gmail.com",
    "score": {
      "totalNoOfLoans": 9,
      "totalNoOfActiveLoans": 3,
      "totalNoOfClosedLoans": 6,
      "totalNoOfInstitutions": 2,
      "totalOverdue": 54931635,
      "totalBorrowed": 135582,
      "highestLoanAmount": 45194,
      "totalOutstanding": 54931635,
      "totalMonthlyInstallment": 0,
      "totalNoOfOverdueAccounts": 3,
      "totalNoOfPerformingLoans": 6,
      "totalNoOfDelinquentFacilities": 3,
      "firstCentralEnquiryResultID": "24327937",
      "firstCentralEnquiryEngineID": "178572277",
      "directors": false,
      "loanPerformance": false,
      "creditEnquiries": false,
      "loanHistory": false
    },
    "searchedDate": "2023-11-23T16:17:16.672Z"
  }
}

​
Field Descriptions

FieldDescriptionType
statusThis is the returned status of the request either success or failed.String
codeThis is the operational code.Number
dataThis is an array of objects which contains every transaction data.Object
- _idThe unique identifier or specific code assigned to a particular user within the database.String
- bvnThe BVN of the user.String
- customerIdThe unique identifier or specific code assigned to a particular customer.String
- businessIdThe unique identifier or specific code assigned to a particular business.String
- nameThe full name of the BVN holder.String
- phoneThe phone number of the BVN holder.String
- genderThe gender of the BVN holder.String
- dateOfBirthThe date of birth of the BVN holder.String
- addressThe address of the BVN holder.String
- emailThe email of the BVN holder.String
- scoreThis is an array of objects which contains every score.Object
-- totalNoOfDelinquentFacilitiesThe count of accounts or credit facilities that are overdue or behind on payments according to the credit report.Number
-- lastReportedDateThe most recent date on which information about an account, transaction, or activity was updated or submitted to the credit bureau.Number
-- totalNoOfLoansThe overall count of active loan accounts listed in the credit report.Number
-- totalNoOfInstitutionsThe count of different financial institutions or lenders where the user holds accounts listed within their credit report or financial records.Number
-- totalNoOfActiveLoansThe count of currently open and operational loan accounts listed in a user’s credit report or financial records.Number
-- totalBorrowedThe amount of money that an individual has borrowed across all loans, credit lines, or financial obligations listed within their credit report or financial records.Number
-- totalOutstandingThe overall amount of money that remains unpaid or outstanding across all active loans, credit accounts, or financial obligations listed within the credit report or financial records.Number
-- totalOverdueThe amount that is past due or overdue across all active loans or credit accounts listed within the credit report or financial records.Number
-- maxNoOfDaysThe longest duration an account or payment has been overdue.Number
-- totalNoOfClosedLoansThe overall count of loan accounts that have been successfully paid off or closed by the individual and are no longer active in their credit report or financial records.Number
-- crcReportOrderNumberThe report order number of the credit bureau.String
- searchedDateThe date the credit report was searched.String

What are API limits?