First Central Credit Score
curl --request POST \
--url https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/ \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"bvn": "22244545518"
}
'import requests
url = "https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/"
payload = { "bvn": "22244545518" }
headers = {
"x-access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({bvn: '22244545518'})
};
fetch('https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bvn' => '22244545518'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/"
payload := strings.NewReader("{\n \"bvn\": \"22244545518\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/")
.header("x-access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"bvn\": \"22244545518\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bvn\": \"22244545518\"\n}"
response = http.request(request)
puts response.read_body{
"status": "failed",
"data": [
"<unknown>"
],
"message": "<string>"
}{
"status": "failed",
"message": "Authentication credentials were not provided."
}Individual
First Central Credit Score
Retrieve an individual’s credit score from the First Central bureau using their BVN.
POST
/
api
/
onboarding
/
individual
/
credit_scores_first_central
/
First Central Credit Score
curl --request POST \
--url https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/ \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"bvn": "22244545518"
}
'import requests
url = "https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/"
payload = { "bvn": "22244545518" }
headers = {
"x-access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({bvn: '22244545518'})
};
fetch('https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bvn' => '22244545518'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/"
payload := strings.NewReader("{\n \"bvn\": \"22244545518\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/")
.header("x-access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"bvn\": \"22244545518\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bvn\": \"22244545518\"\n}"
response = http.request(request)
puts response.read_body{
"status": "failed",
"data": [
"<unknown>"
],
"message": "<string>"
}{
"status": "failed",
"message": "Authentication credentials were not provided."
}The First Central Credit Score endpoint returns an individual’s consumer credit score from the First Central bureau, along with account condition summaries, outstanding debt totals, and score breakdown metrics.
Endpoint
POST /api/onboarding/individual/credit_scores_first_central/
Request
Headers
| Header | Value | Required |
|---|---|---|
x-access-token | Your API secret key | Yes |
Content-Type | application/json | Yes |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bvn | string | Yes | The individual’s 11-digit Bank Verification Number |
Example
curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/individual/credit_scores_first_central/" \
-H "x-access-token: YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"bvn": "22244545518"}'
Response
200 OK
| Field | Type | Description |
|---|---|---|
data.score.totalConsumerScore | string | Overall consumer credit score |
data.score.description | string | Risk rating (e.g. "LOW RISK", "HIGH RISK") |
data.score.totalAccounts | string | Total accounts on record |
data.score.totalaccountinGoodcondition | string | Accounts in good standing |
data.score.totalaccountinBadcondition | string | Accounts in bad standing |
data.score.totalOutstandingDebt | string | Total outstanding debt |
data.score.totalAmountOverdue | string | Total amount overdue |
data.score.repaymentHistoryScore | string | Repayment history score component |
data.score.firstCentralEnquiryResultID | string | First Central enquiry result ID |
{
"status": "success",
"data": {
"_id": "64f600608aaf9386c646de32",
"bvn": "22244545518",
"name": "ADELEKE EMMANUEL AYORINDE",
"score": {
"totalConsumerScore": "835",
"description": "LOW RISK",
"totalAccounts": "23",
"scoreDate": "11/23/2023",
"noOfAcctScore": "55/55",
"totalaccountinGoodcondition": "23",
"totalaccountinBadcondition": "0",
"totalOutstandingDebt": "30,719.00",
"totalAccountarrear": "0",
"totalAmountOverdue": "0.00",
"repaymentHistoryScore": "192/192",
"totalAmountOwedScore": "165/165",
"firstCentralEnquiryResultID": "37181617"
},
"searchedDate": "2023-11-23T14:37:04.152Z"
},
"message": "Credit Scores individual first central report details retrieved 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."
}
⌘I

