1. KYC
Core Banking Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Product List
      GET
    • Create Account
      POST
    • Update Account
      PUT
    • Find Client
      POST
    • Accounts
      GET
    • Create Additional Account
      POST
    • Account Details By BVN
      GET
    • Get Client Addresses
      GET
    • Get Account Details
      GET
    • Get Account Summary
      GET
    • Client Images
      GET
    • Update BVN
      POST
    • Update Transaction Limit
      POST
    • Client Notifications
      PUT
    • Activate Client Account
      POST
    • Add Client Address
      POST
    • Update Client Address
      PUT
    • Get Full Account Details
      GET
    • Get Full Account Details By NUBAN
      GET
    • Upload Client Passport
      POST
    • Update NIN
      POST
    • Create Client
      POST
    • Get Directors
      GET
    • Create Directors
      POST
    • Update Directors
      PUT
    • Delete Director
      DELETE
    • Get Genders
      GET
    • Get Signatories
      GET
    • Create Signatories
      POST
    • Delete Signatory
      DELETE
    • Get Template
      GET
  • KYC
    • Get KYC Info
      POST
    • Update KYC
      POST
    • Get KYC Level
      GET
    • Auto Verify KYC
      POST
    • Get KYC Comparison Details
      GET
    • Face Comparison
      POST
    • Get KYC Info
      POST
    • Get KYC Settings
      GET
    • Get KYC Info
      POST
    • Create Face Liveness Session
      POST
    • Get KYC Log Details
      GET
    • Get KYC Logs
      GET
    • Set KYC Level
      POST
    • Set KYC Log Status
      POST
  • Transaction
    • Payment Types
    • Debit Account
    • Credit Account
    • Transaction History
    • Transaction Details [Legacy]
    • Transaction Details
    • Get All Transactions
  • Transfer
    • Interbank Transfer
      • Get Institutions
      • Name Inquiry
      • Interbank Transfer
      • InterBank Transfer Query
      • Transfer Details
      • Bulk Interbank Transfer
    • Intrabank Transfer
      • IntraBank Transfer
      • Intrabank Transfer To Virtual Accounts
      • Query Intrabank Transfer Status
      • Intrabank Transfer To Virtual Accounts
      • Query Intrabank Transfer To Virtual Account Status
  • Account Restrictions
    • Block Debit
    • Unblock Debit
    • Hold Amount
    • Release Amount
    • Block Account
    • Block Account Credits
    • Unblock Account
    • Unblock Account Credits
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  • Organisation
    • Get Address Types
    • Get Offices
    • Get States
  • Schemas
    • Client
    • Product
    • ClientNotificationsRequest
    • ClientNotificationsResponse
    • ErrorDetail
    • ErrorResponse
    • ValidationErrorResponse
  1. KYC

Get KYC Logs

GET
/core/kyc/logs/{clientId}

Get KYC Logs#

Lists the KYC lookups recorded for a client, newest first. With failedLogs=true, lookups that failed (invalid number or network error) are appended.
GET /core/kyc/logs/{clientId}

Path Parameter#

Field NameTypeRequiredDescription
clientIdLongTRUEClient id

Query Parameters#

Field NameTypeRequiredDescription
failedLogsBooleanFALSEInclude failed lookups. Defaults to false

Response#

Array of log entries.
Field NameTypeDescription
idLongLog id. Use with the log detail endpoints
informationTypeStringBVN, NIN or CAC
kycProviderStringProvider that answered
kycNumberStringNumber looked up
verifiedStatusBooleanWhether the log has been marked verified
verificationDoneByLongUser id that verified it
clientIDLongClient id
createdDate / createdDateStringDate / StringWhen the lookup was made
resultStringFailure label for failed logs (e.g. Invalid BVN)
failedLogBooleanTrue for failed lookups

Request

Authorization
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers，whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Token URL: {{tpGatewayHostUrl}}/security/authenticate
or
Path Params

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/core/kyc/logs/?failedLogs=undefined'

Responses

🟢200Success
application/json
Success
Bodyapplication/json

Example
[
  {
    "id": 101,
    "informationType": "BVN",
    "kycProvider": "PROVIDER",
    "kycNumber": "22000000000",
    "verifiedStatus": true,
    "verificationDoneBy": 5,
    "clientID": 1,
    "createdDate": "2025-10-01T09:30:00.000+00:00",
    "createdDateString": "01 October 2025",
    "result": null,
    "failedLog": false
  }
]
🟠400| Source | Error | When |
🟠401| Source | Error | When |
🟠403| Source | Error | When |
🟠404| Source | Error | When |
🔴500| Source | Error | When |
Modified at 2026-11-02 05:49:15
Previous
Get KYC Log Details
Next
Set KYC Level
Built with