Identification

dojah.identification.validate_bvn(bvn, first_name, last_name,dob)

This method Validates a bvn

Usage

from dojahcore.dojah import Dojah

api =  Dojah()

try:
    bvn_result  =  api.identification.validate_bvn(bvn, first_name, last_name,dob)

    print(bvn_result)
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
bvn * string The bank verification number to validate required
first_name * string The first_name to validate against the bvn required
last_name * string The last_name to validate against the bvn required
dob * string The date of birth to validate against the bvn yyyy-mm-dd required

Response

{
   "bvn":"22468537919",
   "last_name":{
      "confidence_value":100,
      "status":true
   },
   "first_name":{
      "confidence_value":100,
      "status":true
   },
   "date_of_birth":{
      "status":true
   },
   "phone_number":{
      "status":true
   },
   "status":200
}

dojah.identification.lookup_bvn_basic(bvn)

This Method Return details of a particular bvn

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    bvn_details = api.identification.lookup_bvn_basic('22275036375')
    print(bvn_details)
    
except Exception as e:
    print(str(e))
Arguments Type Description
bvn * string The bank verification number to validate required

Response

{
   "bvn":"22171234567",
   "first_name":"JOHN",
   "last_name":"DOE",
   "middle_name":"AHMED",
   "gender":"Male",
   "date_of_birth":"25-May-1901",
   "phone_number1":"08012345678",
   "image":"BASE 64 IMAGE"
}

dojah.identification.lookup_bvn_advance(bvn)

This Method Validates a bvn

Usage

from dojahcore.dojah import Dojah

api =  Dojah()

try:
    bvn_result  =  api.identification.lookup_bvn_advance(bvn)

    print(bvn_result)
except Exception as e:
    print(str(e))
Arguments Type Description
bvn * string The bank verification number to validate required

Response

{
   "bvn":"22171234567",
   "first_name":"JOHN",
   "last_name":"DOE",
   "middle_name":"AHMED",
   "gender":"Male",
   "date_of_birth":"25-May-1901",
   "phone_number1":"08012345678",
   "image":"BASE 64 IMAGE",
   "email":"[email protected]",
   "enrollment_bank":"GTB",
   "enrollment_branch":"IKEJA",
   "level_of_account":"LEVEL 2",
   "lga_of_origin":"OSOGBO",
   "lga_of_residence":"IKEJA",
   "marital_status":"SINGLE",
   "name_on_card":"",
   "nationality":"NIGERIAN",
   "nin":"70123456789",
   "phone_number2":"08012345678",
   "registration_date":"",
   "residential_address":"",
   "state_of_origin":"OSUN",
   "state_of_residence":"LAGOS",
   "title":"MISS",
   "watch_listed":"NO"
}

dojah.identification.lookup_nuban(account_number, bank_code)

This Method Return details of a particular bvn

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    bvn_details = api.identification.lookup_nuban('0222222222','051)
    print(bvn_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
account_number * string The account number to lookup required
bank_code * string The bank code required

Response

{
   "account_currency":"566",
   "account_name":"ADAMU GARBA",
   "account_number":"0012345678",
   "account_type":"10",
   "address_1":"788,Abuja Nigeria,",
   "address_2":"Abuja.",
   "city":"Abuja",
   "country_code":"NG",
   "country_of_birth":"NIGERIA",
   "country_of_issue":"Nigeria",
   "dob":"01/01/1980",
   "expiry_date":"",
   "first_name":"Adamu",
   "identity_number":"22200123456",
   "identity_type":"BVN",
   "last_name":"Garba",
   "nationality":"NIGERIA",
   "other_names":"",
   "phone":"08061234567",
   "postal_code":"",
   "state_code":"Abuja",
   "status":200
}

dojah.identification.lookup_nin(nin)

This Method fetch customers details using the National Identification Number (NIN) of the customer

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    nin_details = api.identification.lookup_nin('0244338487')
    print(nin_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
nin * string The national identification number to lookup required

Response

{
   "nin":"70123456789",
   "firstname":"John",
   "middlename":"Doe",
   "surname":"Adamu",
   "maidenname":"",
   "telephoneno":"08011111111",
   "state":"Ekiti",
   "place":"ADO ",
   "profession":"STUDENT",
   "title":"mr",
   "height":"****",
   "email":"",
   "birthdate":"18-05-1901",
   "birthstate":"Ekiti",
   "birthcountry":"nigeria",
   "centralID":"5227000",
   "documentno":"",
   "educationallevel":"",
   "employmentstatus":"",
   "nok_firstname":"Musa",
   "nok_lastname":"Adamu",
   "nok_middlename":"Garba",
   "nok_address1":"FEDERAL UNIVERSITY TECHN",
   "nok_address2":"",
   "nok_lga":"Bosso",
   "nok_state":"Niger",
   "nok_town":"MINNA",
   "nok_postalcode":"",
   "othername":"",
   "pfirstname":"",
   "photo":"/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDB...",
   "pmiddlename":"",
   "psurname":"",
   "nspokenlang":"YORUBA",
   "ospokenlang":"ENGLISH",
   "religion":"christianity",
   "residence_Town":"IKOTUN EGBE",
   "residence_lga":"Alimosho",
   "residence_state":"Lagos",
   "residencestatus":"birth",
   "residence_AddressLine1":"26 London Street",
   "residence_AddressLine2":"",
   "self_origin_lga":"Alimosho",
   "self_origin_place":"",
   "self_origin_state":"Lagos",
   "signature":"/9j/4AAQSkZJRgABAQEAlgCWAAD/2wBDAAgGBgcGBQgHBwcJCQg...",
   "nationality":"",
   "gender":"m",
   "trackingId":"S4Y0ABFD50007WS",
   "status":200
}

dojah.identification.lookup_phone_number_basic(phone_number)

This Method Return details of a particular phone number

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    phone_details = api.identification.lookup_phone_number_basic(phone_number)
    print(phone_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
phone_number * string The phone number to lookup required

Response

{
   "msisdn":"2348103100000",
   "firstName":"John",
   "lastName":"Doe",
   "email":"[email protected]",
   "encryptedPan":"1235246646GVDG",
   "dateOfBirth":"18/08/1997",
   "bvn":"2222222222",
   "address":" 25 Okota",
   "address_city":"Shomolu",
   "address_state":"Lagos",
   "account_number":"1234567897",
   "bank_code":"054",
   "gender":"Male",
   "status":200
}

dojah.identification.lookup_phone_number(phone_number)

This Method Return details of a particular phone number

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    phone_details = api.identification.lookup_phone_number(phone_number)
    print(phone_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
phone * string The phone number to lookup required

Response

{
   "msisdn":"09011111111",
   "firstName":"John",
   "middleName":"Doe",
   "lastName":"Doe",
   "maritalStatus":"Married",
   "gender":"Male",
   "birthDate":"11-11-1972",
   "birthLga":"Ikeja",
   "birthState":"Lagos",
   "educationalLevel":"Higher",
   "emplymentStatus":"25 ikeja",
   "nspokenLang":"English",
   "ospokenlang":"Yoruba",
   "profession":"Tailor",
   "religion":"Muslim",
   "residenceAddressLine1":"25 Agege motor ways",
   "residenceTown":"Oshogbo",
   "residenceLga":"Ikeja",
   "residenceState":"Lagos",
   "residenceStatus":"Occupant",
   "selfOriginLga":"Lagos Island",
   "selfOriginPlace":"Yaba",
   "selfOriginState":"Muslim",
   "state":"Lagos",
   "lga":"Ikeja",
   "nin":"111111111111111",
   "title":"Mr",
   "height":"5 9",
   "pi
cture":"BASE 4 encrypted",
   "status":200
}

dojah.identification.lookup_vin_dob(state, first_name, last_name,dob)

This Method Lookup VIN via date of birth

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    vin_details = api.identification.lookup_vin_dob('Lagos','John','Doe','1993-09-22')
    print(vin_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
state * string A state in Nigeria required
first_name * string First name of VIN holder required
last_name * string Last name of VIN holder required
dob * string Date of birth in yyy-mm-dd format required

Response

{
   "full_name":"JOHN DOE S",
   "voter_identification_number:":"90F5B1C5B1234567890",
   "gender:":"Male",
   "occupation:":"STUDENT",
   "time_of_registration:":"2011-01-18 13:59:46",
   "state:":"ONDO",
   "local_government:":"IDANRE",
   "registration_area_ward:":"ISALU JIGBOKIN",
   "polling_unit:":"OJAJIGBOKIN, O/S IN FRONT OF ABANA I & II",
   "polling_unit_code":"28/08/08/005",
   "status":200
}

dojah.identification.lookup_vin(cls,vin, state, last_name)

This Method Return details of a particular VIN

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    vin_details = api.identification.lookup_vin('90F5B1C5B1234567890', 'Lagos', 'Doe')
    print(vin_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
vin * string The VIN to lookup required
state * string A state in Nigeria required
last_name * string The last name of the holder required

Response

{
   "full_name":"JOHN DOE S",
   "voter_identification_number:":"90F5B1C5B1234567890",
   "gender:":"Male",
   "occupation:":"STUDENT",
   "time_of_registration:":"2011-01-18 13:59:46",
   "state:":"ONDO",
   "local_government:":"IDANRE",
   "registration_area_ward:":"ISALU JIGBOKIN",
   "polling_unit:":"OJAJIGBOKIN, O/S IN FRONT OF ABANA I & II",
   "polling_unit_code":"28/08/08/005",
   "status":200
}

dojah.identification.lookup_driver_licence(license_number, dob)

This Method Return details of a license

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    driver_licence = api.identification.lookup_driver_licence('90F5B1C5B1234567890','1998-09-22')
    print(driver_licence)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
license_number * string A driver's license number required
dob * string Date of birth in yyy-mm-dd format required

Response

{
   "uuid":"1625583696",
   "licenseNo":"FKJ494A2133",
   "firstName":"JOHN",
   "lastName":"DOE",
   "middleName":"",
   "gender":"Male",
   "issuedDate":"2019-01-25",
   "expiryDate":"2024-08-17",
   "stateOfIssue":"LAGOS",
   "birthDate":"28-09-1998",
   "photo":"BASE 64 IMAGE"
}

dojah.identification.lookup_cac(rc_number,company_name)

This Method Return details of a particular company

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    coy_details = api.identification.lookup_cac('1237654','ABC Company LIMITED')
    print(coy_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
rc_number * string The company's RC number required
company_name * string The name of the company required

Response

{
   "rc_number":"1237654",
   "company_name":"ABC Company LIMITED",
   "address":"NO 37 Lagos Road, Nigeria",
   "date_of_registration":"2015-05-15",
   "status":200
}

dojah.identification.lookup_tin(tin)

This Method Return details of a particular tin

Usage

from dojahcore.dojah import Dojah

try :
    api = Dojah()
    tin_details = api.identification.lookup_tin('1234444')
    print(tin_details)
    
except Exception as e:
    print(str(e))

Arguments

Arguments Type Description
tin * string A valid tax identification number required

Response

{
   "search":"07012345678",
   "taxpayer_name":"JOHN DOE NIG LTD",
   "cac_reg_number":"RC123456",
   "firstin":"12345678-0001",
   "jittin":"N/A",
   "tax_office":"MSTO ALIMOSHO",
   "phone_number":"07012345678",
   "email":"",
   "status":200
}

Did this page help you?