Customer Verification

post

Basic bank account verification for South African individuals, returning the verification status, result, and any failure reasons if verification is unsuccessful.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

Schema for verifying consumer bank details, including personal identification and banking information. This verification is essential for ensuring compliance and validating customer identities in banking relationships.

id_numberstringOptional

The unique identification number of the individual, which may be a national ID number, passport number, or nationa temporary ID number.

identity_typestringOptional

The type of identification document provided. Supported ID types: IDNumber, Passport or TempIDNumber.

first_namestringOptional

The first name of the individual.

middle_namestringOptional

The middle name of the individual, if applicable.

last_namestringOptional

The last name or surname of the individual.

initialsstringOptional

Initials representing the individual's first and middle names.

account_numberstringOptional

The bank account number associated with the individual's bank account.

account_typestringOptional

The type of the bank account. Supported account types include current, savings, transmission, bond, subscription share, or cheque.

bank_namestringOptional

The name of the bank associated with the account. Supported banks include: ABSA, ACCESS BANK, AFRICAN BANK, BIDVEST BANK, CAPITEC BANK, DISCOVERY BANK, FINBOND MUTUAL BANK, FNB, GRINROD BANK, INVESTEC BANK, MERCANTILE BANK, NEDBANK, SASFIN BANK, STANDARD BANK , TYME BANK and UBANK.

emailstringOptional

The email address of the individual

contact_numberstringOptional

The contact number of the individual.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

Response object containing the results of the ID verification process within Akibaone.

StatusstringOptional

The result of the endpoint operation, indicating whether the operation was 'Success' or 'Failed'.

VerificationbooleanOptional

Indicates if the ID verification was successful (true) or not (false).

OutcomeReasonstringOptional

Detailed reason for any verification failure, if applicable.

404Error

application/json

412Error

application/json

post

/api/v3/bankverification/consumer

POST /api/v3/bankverification/consumer HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 240

{
  "id_number": "text",
  "identity_type": "text",
  "first_name": "text",
  "middle_name": "text",
  "last_name": "text",
  "initials": "text",
  "account_number": "text",
  "account_type": "text",
  "bank_name": "text",
  "email": "text",
  "contact_number": "text",
  "consent": true
}

{
  "Status": "text",
  "Verification": true,
  "OutcomeReason": "text"
}

post

This service generates a consumer trace PDF report and returns a status, a ticket number, and the PDF in Base64 format.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

ticket_numberstringOptional

Ticket number from the /api/consumer/expresstrace service.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

Response object containing the generated PDF (in Base64-encoded form) and related metadata.

StatusstringOptional

The overall status of the PDF generation request (e.g., 'Success' or 'Failure').

TicketNumberstringOptional

A unique reference number associated with this PDF generation request.

PDFBytesstringOptional

Base64-encoded string representing the generated PDF content.

404Error

application/json

412Error

application/json

post

/api/consumer/expresstrace/pdfreport

POST /api/consumer/expresstrace/pdfreport HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "ticket_number": "text",
  "consent": true
}

{
  "Status": "text",
  "TicketNumber": "text",
  "PDFBytes": "text"
}

post

Basic ID verification for South African individuals, returning the verification status, result, and any failure reasons if verification is unsuccessful.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

first_namestringOptional

The first name of the individual.

last_namestringOptional

The last name of the individual.

id_numberstringOptional

The South African identification number of the individual.

Responses

200Success

application/json

Response object containing the results of the ID verification process within Akibaone.

StatusstringOptional

The result of the endpoint operation, indicating whether the operation was 'Success' or 'Failed'.

VerificationbooleanOptional

Indicates if the ID verification was successful (true) or not (false).

OutcomeReasonstringOptional

Detailed reason for any verification failure, if applicable.

404Error

application/json

412Error

application/json

post

/api/v4/idverification

POST /api/v4/idverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "first_name": "text",
  "last_name": "text",
  "id_number": "text"
}

{
  "Status": "text",
  "Verification": true,
  "OutcomeReason": "text"
}

post

The Know Your Customer (KYC) Verification Endpoint is designed to authenticate and validate the identities of individuals by verifying key personal information. This process ensures that individuals are who they claim to be, thereby mitigating risks associated with fraudulent activities and aiding compliance with regulatory requirements.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

first_namestringOptional

The first name of the individual.

last_namestringOptional

The last name of the individual.

id_numberstringOptional

The South African identification number of the individual.

Responses

200Success

application/json

Response object containing the results of the ID verification process within Akibaone.

StatusstringOptional

The result of the endpoint operation, indicating whether the operation was 'Success' or 'Failed'.

VerificationbooleanOptional

Indicates if the ID verification was successful (true) or not (false).

404Error

application/json

412Error

application/json

post

/api/kyc/verification

POST /api/kyc/verification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "first_name": "text",
  "last_name": "text",
  "id_number": "text"
}

{
  "Status": "text",
  "Verification": true,
  "Data": {
    "OnNPR": true,
    "OnHANIS": true,
    "Photo": "text",
    "MaritalStatus": "text",
    "IdBlocked": true,
    "DeceasedStatus": true,
    "IdIssueDate": "text",
    "SmartCardIssued": true,
    "Surname": "text",
    "Names": "text",
    "IdNumber": "text",
    "FacialImageAvailable": true
  }
}

post

A comprehensive bank account verification report designed for both individual consumers and business entities. This report provides detailed verification results, including account status, identity matches, and compliance information, to support Know Your Customer (KYC) processes and ensure accurate and reliable account validations.

Required scopes

This endpoint requires the following scopes:

: Business related verification on fields such as the business registration number or director information.
: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

bank_namestringOptional

account_numberstringOptional

The valid account number.

account_typestringOptional

Type of the bank account. Supported values include: unknown, current, savings, transmission, bond, subscriptionshare or cheque.

identity_typestringOptional

Type of identification used. Expected values: 'IDNumber', 'Passport', 'TempIDNumber', 'CompanyRegNumber'.

id_numberstringOptional

The valid identification number corresponding to the identity type. For 'CompanyRegNumber', the expected format is 'XXXX/XXXXXX/XX'.

first_namestringOptional

First name of the account holder or the registered business name.

middle_namestringOptional

Middle name of the account holder.

last_namestringOptional

Last name of the account holder.

initialsstringOptional

Initials of the account holder.

contact_numberstringOptional

Contact phone number of the account holder.

emailstringOptional

Email address of the account holder.

Responses

200Success

application/json

The full response object for the compliance KYC process.

StatusstringOptional

The status of the operation, indicating success or failure.

ApplicationIdstringOptional

A unique identifier for this application request, used to correlate and track requests throughout the system.

404Error

application/json

412Error

application/json

post

/api/v1/bankverification

POST /api/v1/bankverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 225

{
  "bank_name": "text",
  "account_number": "text",
  "account_type": "text",
  "identity_type": "text",
  "id_number": "text",
  "first_name": "text",
  "middle_name": "text",
  "last_name": "text",
  "initials": "text",
  "contact_number": "text",
  "email": "text"
}

{
  "Status": "text",
  "ApplicationId": "text",
  "DRAVSPlusV2": {
    "ResponseSize": 1,
    "APIResponseTime": "text",
    "TimeOfRequest": "2026-03-21T01:23:01.491Z",
    "AVSPlusRiskOutcome": "text"
  },
  "DSAVSPlusV2": {
    "requestId": "text",
    "customerReference": "text",
    "avsRequestId": 1,
    "status": "text",
    "statusMessage": "text",
    "accountFound": "text",
    "accountOpen": "text",
    "acceptsCredits": "text",
    "acceptsDebits": "text",
    "lengthOpen": "text",
    "identityMatch": "text",
    "accountTypeMatch": "text",
    "initialsMatch": "text",
    "nameMatch": "text",
    "emailMatch": "text",
    "phoneMatch": "text",
    "bankReference": "text",
    "bankStatusCode": "text",
    "bankStatusMessage": "text",
    "bankResponseTimestamp": "2026-03-21T01:23:01.491Z",
    "validationErrors": "text",
    "allowDebiCheck": true,
    "allowDCProcessOnSunday": true,
    "allowRTC": true,
    "allowRealtimeAVS": true,
    "allowBatchAVS": true,
    "bankName": "text"
  }
}

post

The Consumer Express Trace service enables a user to submit a South African ID Number and in return the user will receive the following information, Registered Names and Surname, Date of Birth., Age, Gender, Last 5 Know Addresses, Last 5 Know Telephones, Last 5 Know employers and Deceased Status.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

Consumer ID number

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

ResponseStatusstringOptional

The status of the response, e.g., 'Success'.

TicketNumberstringOptional

Ticket number

404Error

application/json

412Error

application/json

post

/api/consumer/expresstrace

POST /api/consumer/expresstrace HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "id_number": "text",
  "consent": true
}

{
  "ResponseStatus": "text",
  "AddressNA08": {
    "ConsumerNo": "text",
    "InformationDate": "2026-03-21",
    "Line1": "text",
    "Line2": "text",
    "Suburb": "text",
    "City": "text",
    "PostalCode": "text",
    "ProvinceCode": "text",
    "Province": "text",
    "AddressPeriod": "text",
    "OwnerTenant": "text",
    "AddressChanged": "text"
  },
  "AKANamesNK04": {
    "RecordSeq": "text",
    "Part": "text",
    "PartSeq": "text",
    "ConsumerNo": "text",
    "InformationDate": "2026-03-21",
    "AKAName": "text"
  },
  "ConsumerInfoNO05": {
    "RecordSeq": "text",
    "Part": "text",
    "PartSeq": "text",
    "ConsumerNo": "text",
    "Surname": "text",
    "Forename1": "text",
    "Forename2": "text",
    "Forename3": "text",
    "Title": "text",
    "Gender": "text",
    "NameInfoDate": "2026-03-21",
    "DateOfBirth": "2026-03-21",
    "IdentityNo1": "text",
    "IdentityNo2": "text",
    "MaritalStatusCode": "text",
    "MaritalStatusDesc": "text",
    "Dependants": "text",
    "SpouseName1": "text",
    "SpouseName2": "text",
    "TelephoneNumbers": "text",
    "CellNumber": "text",
    "EMail": "text"
  },
  "ConsumerTelephoneHistoryNW01": {
    "ConsumerNo": "text",
    "WorkNumbers": {
      "PhoneNumber": [
        {
          "AreaCode": "text",
          "Number": "text",
          "Date": "text",
          "Years": "text"
        }
      ]
    },
    "HomeNumbers": {
      "PhoneNumber": [
        {
          "AreaCode": "text",
          "Number": "text",
          "Date": "text",
          "Years": "text"
        }
      ]
    },
    "CellNumbers": {
      "PhoneNumber": [
        {
          "Number": "text",
          "Date": "text",
          "Years": "text"
        }
      ]
    }
  },
  "EmploymentNM04": {
    "RecordSeq": "text",
    "Part": "text",
    "PartSeq": "text",
    "ConsumerNo": "text",
    "InformationDate": "2026-03-21",
    "Occupation": "text",
    "EmployerName": "text",
    "EmploymentPeriod": "text"
  },
  "TicketNumber": "text"
}

post

The Consumer Trace service enables a user to submit a South African ID Number and in return the user will receive the following information, Registered Names and Surname, Date of Birth., Age, Gender, Last 5 Know Addresses, Last 5 Know Telephones, Last 5 Know employers and Deceased Status.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

Consumer ID number

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

ResponseStatusstringOptional

404Error

application/json

412Error

application/json

post

/api/v2/consumertrace

POST /api/v2/consumertrace HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "id_number": "text",
  "consent": true
}

{
  "ResponseStatus": "text",
  "AddressNA08": {
    "AddressNA08": [
      {
        "ConsumerNo": "text",
        "InformationDate": "text",
        "Line1": "text",
        "Line2": "text",
        "Suburb": "text",
        "City": "text",
        "PostalCode": "text",
        "ProvinceCode": "text",
        "Province": "text",
        "AddressPeriod": "text",
        "OwnerTenant": "text",
        "AddressChanged": "text"
      }
    ]
  },
  "AddressVerificationNR01": {
    "Last24Hours": "text",
    "Last48Hours": "text",
    "Last96Hours": "text",
    "Last30Days": "text",
    "AddressMessage": "text"
  },
  "AKANamesNK04": {
    "AKANamesNK04": [
      {
        "RecordSeq": "text",
        "Part": "text",
        "PartSeq": "text",
        "ConsumerNo": "text",
        "InformationDate": "text",
        "AKAName": "text"
      }
    ]
  },
  "ConsumerInfoNO05": {
    "RecordSeq": "text",
    "Part": "text",
    "PartSeq": "text",
    "ConsumerNo": "text",
    "Surname": "text",
    "Forename1": "text",
    "Forename2": "text",
    "Forename3": "text",
    "Title": "text",
    "Gender": "text",
    "NameInfoDate": "text",
    "DateOfBirth": "text",
    "IdentityNo1": "text",
    "IdentityNo2": "text",
    "MaritalStatusCode": "text",
    "MaritalStatusDesc": "text",
    "Dependants": "text",
    "SpouseName1": "text",
    "SpouseName2": "text",
    "TelephoneNumbers": "text",
    "DeceasedDate": "text",
    "CellNumber": "text",
    "EMail": "text"
  },
  "ConsumerTelephoneHistoryNW01": {
    "ConsumerNo": "text",
    "WorkNumbers": {
      "PhoneNumber": [
        {
          "AreaCode": "text",
          "Number": "text",
          "Date": "text",
          "Years": "text"
        }
      ]
    },
    "HomeNumbers": {
      "PhoneNumber": [
        {
          "AreaCode": "text",
          "Number": "text",
          "Date": "text",
          "Years": "text"
        }
      ]
    },
    "CellNumbers": {
      "PhoneNumber": [
        {
          "Number": "text",
          "Date": "text",
          "Years": "text"
        }
      ]
    }
  },
  "DebtCounsellingDC01": {
    "ConsumerNo": "text",
    "DebtCounsellingDate": "text",
    "DebtCounsellingCode": "text",
    "DebtCounsellingDescription": "text"
  },
  "DefaultD703": {
    "DefaultD703": [
      {
        "RecordSequence": "text",
        "Part": "text",
        "PartSequence": "text",
        "ConsumerNo": "text",
        "ContactName": "text",
        "TelephoneCode": "text",
        "TelephoneNumber": "text",
        "InformationDate": "text",
        "SupplierName": "text",
        "AccountNo": "text",
        "SubAccount": "text",
        "Branch": "text",
        "DefaultTypeCode": "text",
        "DefaultType": "text",
        "DefaultAmount": "text",
        "WrittenOffDate": "text",
        "Surname1": "text",
        "Forename1": "text",
        "Forename2": "text",
        "Forename3": "text",
        "IdentityNumber": "text",
        "DateOfBirth": "text",
        "AddressLine1": "text",
        "AddressLine2": "text",
        "AddressLine3": "text",
        "AddressLine4": "text",
        "Postcode": "text",
        "Remarks1": "text",
        "Remarks2": "text",
        "InformationMessage": "text"
      }
    ]
  },
  "EmploymentNM04": {
    "EmploymentNM04": [
      {
        "RecordSeq": "text",
        "Part": "text",
        "PartSeq": "text",
        "ConsumerNo": "text",
        "InformationDate": "text",
        "Occupation": "text",
        "EmployerName": "text",
        "EmploymentPeriod": "text"
      }
    ]
  },
  "EnquiriesNE51": {
    "EnquiryNE51": [
      {
        "ConsumerNo": "text",
        "DateOfEnquiry": "text",
        "Subscriber": "text",
        "Contact": "text",
        "EnquiryTypeCode": "text",
        "EnquiryTypeDescription": "text",
        "OwnAccount": "text",
        "InformationMessage": "text"
      }
    ]
  },
  "HistoricContactDetailsHQ": {
    "HistoricContactDetailsHQ": [
      {
        "HistoryDataType1": "text",
        "HistoryAddressDate": "text",
        "HistoryAddressPeriod": "text",
        "HistoryAddressLine": "text",
        "HistoryTelephoneNumber": "text",
        "HistoryTelephoneDate": "text",
        "HistoryTelephonePeriod": "text"
      }
    ]
  },
  "JudgementsNJ09": {
    "JudgementsNJ09": [
      {
        "RecordSeq": "text",
        "Part": "text",
        "PartSeq": "text",
        "ConsumerNo": "text",
        "JudgmentDate": "text",
        "Amount": "text",
        "Plaintiff": "text",
        "JudgmentTypeCode": "text",
        "JudgmentTypeDesc": "text",
        "CourtTypeCode": "text",
        "CourtTypeDesc": "text",
        "CourtNameCode": "text",
        "CourtNameDesc": "text",
        "CaseNo": "text",
        "NatureOfDebtCode": "text",
        "NatureOfDebtDesc": "text",
        "Remarks": "text",
        "CaptureDate": "text",
        "Surname1": "text",
        "Surname2": "text",
        "Forename1": "text",
        "Forename2": "text",
        "Forename3": "text",
        "Title": "text",
        "DefendantNumber": "text",
        "Address": "text",
        "PostSuburbCode": "text",
        "TradingAsName": "text",
        "DateOfBirth": "text",
        "IDNo": "text",
        "DefendantMagisterialDistrict": "text",
        "AdministrationMonthlyAmount": "text",
        "AdministrationNumberOfMonths": "text",
        "AdministrationDate": "text",
        "BondPercentage": "text",
        "AttorneyName": "text",
        "AttorneyReference": "text",
        "AttorneyTelephone": "text",
        "InformationMessage": "text"
      }
    ]
  },
  "PrincipalDeedsCA": {
    "PrincipalDeedsComprehensiveCA": [
      {
        "MajorProduct": "text",
        "Date": "text",
        "Comment": "text",
        "PurchasePrice": "text",
        "PurchaseDate": "text",
        "PropertySize": "text",
        "BondNumber": "text",
        "BondHolder": "text",
        "BondAmount": "text",
        "BondDate": "text",
        "MultipleOwners": "text",
        "Share": "text",
        "DateOfBirthOrIDNumber": "text",
        "ERF": "text",
        "PropertyType": "text",
        "Farm": "text",
        "PropertyName": "text",
        "SchemeName": "text",
        "SchemeNumber": "text",
        "Portion": "text",
        "Title": "text",
        "Township": "text",
        "DeedsOffice": "text",
        "RowID": "text",
        "Street": "text",
        "Province": "text",
        "StreetNumber": "text"
      }
    ]
  },
  "TraceAlertTL": {
    "TraceAlertFound": "text"
  },
  "TicketSuccessConfirmationFR": {
    "TicketNumber": "text",
    "Success": "text"
  }
}

post

Biometric ID check using an ID number and photo. Verified in real-time using offline database resources. Including a liveliness check.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

RSA ID Number

id_photostringOptional

Base64 encode ID photo

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

Top-level object containing all details and outcomes for live photo and liveness verification of a South African ID using cached data.

StatusstringOptional

Indicates the success or failure of the verification operation.

ApplicationIdnumberOptional

A unique identifier for this verification request, used for tracking and audit purposes.

404Error

application/json

412Error

application/json

post

/api/liveidphotoverification

POST /api/liveidphotoverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "id_number": "text",
  "id_photo": "text",
  "consent": true
}

{
  "Status": "text",
  "ApplicationId": 1,
  "DSRSAIdPhotoLiveVerification": {
    "FirstName": "text",
    "LastName": "text",
    "SmartCardIssued": true,
    "IDIssueDate": "text",
    "IDSequenceNo": "text",
    "DeadIndicator": true,
    "IDBlocked": true,
    "OnHANIS": true,
    "OnNPR": true,
    "IdNumber": "text",
    "BirthPlaceCountryCode": "text",
    "FacialImageAvailable": true,
    "FacialImage": "text",
    "TrackingNumber": "text",
    "CachedResult": true,
    "CacheDate": "2026-03-21T01:23:01.491Z",
    "CRef": "text",
    "Status": "text",
    "Message": "text",
    "FaceResult_isIdentical": true,
    "FaceResult_confidence": 1,
    "LivenessResult_LivenessResultScore": 1,
    "LivenessResult_LivenessResultProbability": 1,
    "LivenessResult_LivenessResultQuality": 1,
    "LivenessResult_LivenessResultClass": true,
    "LivenessResult_LivenessPassResult": true,
    "LivenessResult_LivenessMessage": "text"
  },
  "DRRSAIdPhotoLiveVerification": {
    "ResponseSize": 1,
    "TimeOfRequest": "text",
    "APIResponseTime": "text",
    "RSAIdPhotoLiveRiskOutcome": "text"
  }
}

post

Performs basic ID photo verification for a South African ID number and ID phot using offline database sources. This endpoint does not use real-time data from the Department of Home Affairs (DHA).

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

RSA ID Number

id_photostringOptional

Base64 encode ID photo

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

Top-level response object containing metadata and results for South African ID photo verification using cached data.

StatusstringOptional

Indicates the success or failure of the photo verification operation.

ApplicationIdintegerOptional

Unique identifier for the photo verification request, used for tracking and correlation.

404Error

application/json

412Error

application/json

post

/api/v2/idphotoverification

POST /api/v2/idphotoverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "id_number": "text",
  "id_photo": "text",
  "consent": true
}

{
  "Status": "text",
  "ApplicationId": 1,
  "DRRSAIdPhotoVerification": {
    "ResponseSize": 1,
    "TimeOfRequest": "2026-03-21T01:23:01.491Z",
    "APIResponseTime": "text",
    "RSAPhotoRiskOutcome": "text"
  },
  "DSRSAIdPhotoVerification": {
    "FirstName": "text",
    "LastName": "text",
    "SmartCardIssued": true,
    "IDIssueDate": "text",
    "IDSequenceNo": "text",
    "DeadIndicator": true,
    "IDBlocked": true,
    "OnHANIS": true,
    "OnNPR": true,
    "IdNumber": "text",
    "BirthPlaceCountryCode": "text",
    "CacheResult": true,
    "CacheDate": "2026-03-21T01:23:01.491Z",
    "FacialImageAvailable": true,
    "FacialImage": "text",
    "TrackingNumber": "text",
    "Status": "text",
    "Message": "text",
    "FaceResult_isIdentical": true,
    "FaceResult_confidence": 1
  }
}

post

Performs ID verification for a South African ID number using offline database sources. This endpoint does not use real-time data from the Department of Home Affairs (DHA).

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

RSA ID Number

first_namestringOptional

First name

last_namestringOptional

Last name

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

Top-level response structure for a cached/offline South African ID verification request.

StatusstringOptional

Indicates whether the overall verification operation was successful or not.

ApplicationIdintegerOptional

A unique identifier for the ID verification request, used for tracking and correlation.

404Error

application/json

412Error

application/json

post

/api/v3/idverification

POST /api/v3/idverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "id_number": "text",
  "first_name": "text",
  "last_name": "text",
  "consent": true
}

{
  "Status": "text",
  "ApplicationId": 1,
  "DRRSAIdVerification": {
    "ResponseSize": 1,
    "TimeOfRequest": "2026-03-21T01:23:01.491Z",
    "APIResponseTime": "text",
    "ForenameMatchOutcome": "text",
    "SurnameMatchOutcome": "text",
    "RSAIdRiskOutcome": "text"
  },
  "DSRSAIdVerification": {
    "GoldenSource_OnNPR": true,
    "GoldenSource_OnHANIS": true,
    "GoldenSource_Photo": "text",
    "GoldenSource_IdBlocked": "text",
    "GoldenSource_DeadIndicator": "text",
    "GoldenSource_IdSeqNo": "text",
    "GoldenSource_IdIssueDate": "text",
    "GoldenSource_SmartCardIssued": "text",
    "GoldenSource_Surname": "text",
    "GoldenSource_Name": "text",
    "GoldenSource_IdNumber": "text",
    "GoldenSource_BirthPlaceCountryCode": "text",
    "GoldenSource_BirthPlaceCountry": "text",
    "Status": "text",
    "Message": "text",
    "CacheResult": "text",
    "CacheDate": "2026-03-21T01:23:01.491Z",
    "FacialImageAvailable": true
  }
}

post

Consumer Trace service that provides detailed information such as registered names, surname, date of birth, last known addresses, phone numbers, employers, and deceased status, based on a South African ID number.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

South African ID number

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

StatusstringOptional

transaction_idintegerOptional

412Error

application/json

post

/api/consumertrace

POST /api/consumertrace HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "id_number": "text",
  "consent": true
}

{
  "Status": "text",
  "Consumer_Trace": {
    "EnquiryID": "text",
    "DateCreated": "text",
    "DefiniteMatchData": {
      "IdentityNumber": "text",
      "IdentityType": "text",
      "Forename1": "text",
      "Forename2": "text",
      "Forename3": "text",
      "Surname": "text",
      "DateOfBirth": "text",
      "Verified": "text",
      "DateVerified": "text",
      "Deceased": "text",
      "DeceasedDate": "text"
    },
    "AddressData": {
      "AddressDataRecord": [
        {
          "Line1": "text",
          "Line2": "text",
          "Line3": "text",
          "Line4": "text",
          "PostalCode": "text",
          "AddressType": "text",
          "AddressTypeDescription": "text",
          "FirstDateCreated": "text",
          "LastDateUpdated": "text",
          "NumberOfSources": 1,
          "AddressSources": "text"
        }
      ]
    },
    "EmploymentData": {
      "EmploymentDataRecord": [
        {
          "EmpName": "text",
          "Occupation": "text",
          "FirstDateCreated": "text",
          "LastDateUpdated": "text",
          "NumberOfSources": 1,
          "EmploymentSources": "text"
        }
      ]
    },
    "ContactData": {
      "ContactDataRecord": [
        {
          "ContactNumber": "text",
          "AreaCode": "text",
          "CountryCode": "text",
          "ContactType": "text",
          "ContactTypeDescription": "text",
          "FirstDateCreated": "text",
          "LastDateUpdated": "text",
          "NumberOfSources": 1,
          "ContactSources": "text"
        }
      ]
    }
  },
  "transaction_id": 1
}

post

Performs ID verification for a South African ID number using offline database sources.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

South African ID number

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

FirstnamesstringOptional

LastnamestringOptional

DobstringOptional

AgeintegerOptional

GenderstringOptional

CitizenshipstringOptional

DateIssuedstringOptional

412Error

application/json

post

/api/idverification

POST /api/idverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "id_number": "text",
  "consent": true
}

{
  "Firstnames": "text",
  "Lastname": "text",
  "Dob": "text",
  "Age": 1,
  "Gender": "text",
  "Citizenship": "text",
  "DateIssued": "text"
}

post

Obtain the last known South African identities associated with a contact number, using either a landline or mobile number as the search criteria.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

contact_numberstringOptional

South African contact number; eg: Landline 0122215554 or mobile 0823336666.

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

StatusstringOptional

412Error

application/json

post

/api/searchphonenumber

POST /api/searchphonenumber HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "contact_number": "text",
  "consent": true
}

{
  "Status": "text",
  "Contact_Enquiry": {
    "Results": [
      {
        "ID_NUMBER": "text",
        "FORENAME_1": "text",
        "FORENAME_2": "text",
        "SURNAME": "text"
      }
    ]
  }
}

post

Real-time verification of deceased status and name change information from Home Affairs using a South African ID number.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

id_numberstringOptional

South African ID number

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

idNumberstringOptional

inputIdnostringOptional

haIdnostringOptional

haIdBookIssuedDatestringOptional

idCardIndstringOptional

idCardDatestringOptional

identityDocumentTypestringOptional

idBlockedstringOptional

firstNamesstringOptional

surNamestringOptional

dobstringOptional

agestringOptional

genderstringOptional

citizenshipstringOptional

countryofBirthstringOptional

deceasedStatusstringOptional

deceasedDatestringOptional

deathPlacestringOptional

causeOfDeathstringOptional

maritalStatusstringOptional

marriageDatestringOptional

412Error

application/json

post

/api/realtimeidverification

POST /api/realtimeidverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "id_number": "text",
  "consent": true
}

{
  "idNumber": "text",
  "inputIdno": "text",
  "haIdno": "text",
  "haIdBookIssuedDate": "text",
  "idCardInd": "text",
  "idCardDate": "text",
  "identityDocumentType": "text",
  "idBlocked": "text",
  "firstNames": "text",
  "surName": "text",
  "dob": "text",
  "age": "text",
  "gender": "text",
  "citizenship": "text",
  "countryofBirth": "text",
  "deceasedStatus": "text",
  "deceasedDate": "text",
  "deathPlace": "text",
  "causeOfDeath": "text",
  "maritalStatus": "text",
  "marriageDate": "text"
}

post

Verify an ID number and correonding details for supported countries. This API supports Zimbabwe(ZW), Nigeria (NG), South Africa (ZA), Ghana (GH) and Zambia (ZM). Note: Pricing differs from V1.

Required scopes

This endpoint requires the following scopes:

: These APIs allow you to connect and verify customer data such as bank account, bank statement, identity data and company registration data.

Authorizations

OAuth2clientCredentialsRequired

Token URL: Refresh URL:

Body

country_codestringOptional

A string representing the customer's known nationalities, formatted as 2-character country codes separated by commas (e.g., 'NG, ZA'). Country codes are as follows: Nigeria = NG, South Africa = ZA, Ghana = GH, Zambia = ZM and Zimbabwe = ZW

id_typestringOptional

Id type - for Zimbabwe and South Africa = NATIONAL_ID_NO_PHOTO, for Ghana = PASSPORT, SSNIT, VOTER_ID or NEW_VOTER_ID, for Nigeria = BVN, NIN_V2, NIN_SLIP, V_NIN, DRIVERS_LICENSE, or VOTER_ID, and for Zambia = TPIN

id_numberstringOptional

ID number - If country is Zambia put TPIN (Tax Id Number)

first_namestringOptional

First name

last_namestringOptional

Last name

dobstring · dateOptional

Date of birth

genderstringOptional

Gender - Male = M or Female = F

consentbooleanOptional

By using this API, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service. If you have any questions or concerns, please contact us

Responses

200Success

application/json

Root response object for KYC verification containing identity and result details.

StatusstringOptional

Overall status of the verification request (e.g., Success, Failed).

ApplicationIdstringOptional

Unique identifier for this verification request.

IsFinalResultstringOptional

Indicates whether the response is the final result of the verification process.

ResultTextstringOptional

Human-readable description of the result (e.g., ID Number Validated).

ResultTypestringOptional

Type of result returned (e.g., ID Verification).

CountrystringOptional

Country code of the ID being verified (e.g., ZA).

IDNumberstringOptional

The ID number that was verified.

IDTypestringOptional

The type of ID document (e.g., NATIONAL_ID_NO_PHOTO).

AddressstringOptional

Residential or official address, if available.

DOBstringOptional

Date of birth of the individual.

DocumentstringOptional

Associated document (e.g., copy of ID), if available.

ExpirationDatestringOptional

Date the ID document expires, if applicable.

FullNamestringOptional

Concatenated full name of the individual.

GenderstringOptional

Gender of the individual.

IssuanceDatestringOptional

Date the ID document was issued.

PhoneNumberstringOptional

Primary phone number on record, if available.

PhoneNumber2stringOptional

Secondary phone number on record, if available.

PhotostringOptional

Photo of the individual, if available.

Secondary_ID_NumberstringOptional

Any secondary or alternative ID number, if applicable.

OtherNamesstringOptional

Alternative names or aliases, if any.

IsAlivebooleanOptional

Indicates whether the individual is currently alive according to the source data.

timestampstring · date-timeOptional

Timestamp when the verification response was generated.

412Error

application/json

post

/api/v2/idverification

POST /api/v2/idverification HTTP/1.1
Host: api.akibaone.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "country_code": "text",
  "id_type": "text",
  "id_number": "text",
  "first_name": "text",
  "last_name": "text",
  "dob": "2026-03-21",
  "gender": "text",
  "consent": true
}

{
  "Status": "text",
  "ApplicationId": "text",
  "Actions": {
    "Listed": "text"
  },
  "IsFinalResult": "text",
  "ResultText": "text",
  "ResultType": "text",
  "Country": "text",
  "IDNumber": "text",
  "IDType": "text",
  "Address": "text",
  "DOB": "text",
  "Document": "text",
  "ExpirationDate": "text",
  "FullData": {
    "Age": "text",
    "Citizenship": "text",
    "DECEASED_DATE": "text",
    "DECEASED_STATUS": "text",
    "DateIssued": "text",
    "Dob": "2026-03-21",
    "Firstnames": "text",
    "Gender": "text",
    "ID_NUMBER": "text",
    "ID_STATUS": "text",
    "Lastname": "text",
    "success": true
  },
  "FullName": "text",
  "Gender": "text",
  "IssuanceDate": "text",
  "PhoneNumber": "text",
  "PhoneNumber2": "text",
  "Photo": "text",
  "Secondary_ID_Number": "text",
  "OtherNames": "text",
  "IsAlive": true,
  "timestamp": "2026-03-21T01:23:01.491Z"
}

PreviousCredit Bureau Reports NextAuthorization

Last updated 17 days ago