Skip to content
On this page

Get Customer Application KYC

Endpoint for getting a list of customer onboarding application checks, which is representative of the verification checks that were conducted on the applicant's information.

Endpoints

EnvironmentURL
Sandboxhttps://api-test.streamline.laboremus.ug/kyc/api/verifications/lastrun/{profileId}
Productionhttps://api.streamline.laboremus.ug/kyc/api/verifications/lastrun/{profileId}

Request

Request Type : GET

Authorization

There are two ways to be authorized when making this request.

js
const token = 'eyJhbGciOiJIUzI1NiIsInR5.eyJzd...ssw5c'
axios.get(API_ENDPOINT, 
  headers: {
    Authorization: `Bearer ${token}`
  }
)
const token = 'eyJhbGciOiJIUzI1NiIsInR5.eyJzd...ssw5c'
axios.get(API_ENDPOINT, 
  headers: {
    Authorization: `Bearer ${token}`
  }
)
js
import axios from 'axios'
    import oauth from 'axios-oauth-client'
    
    const getClientCredentials = oauth.clientCredentials(
    axios.create(),
    'https://oauth.com/2.0/token',
    'CLIENT_ID',
    'CLIENT_SECRET'
    )

    const auth = await getClientCredentials('OPTIONAL_SCOPES')
    // => { "access_token": "...", "expires_in": 900, ... }

    axios.get(API_ENDPOINT, 
      headers: {
        Authorization: `Bearer ${auth.access_token}`
      }
    )
import axios from 'axios'
    import oauth from 'axios-oauth-client'
    
    const getClientCredentials = oauth.clientCredentials(
    axios.create(),
    'https://oauth.com/2.0/token',
    'CLIENT_ID',
    'CLIENT_SECRET'
    )

    const auth = await getClientCredentials('OPTIONAL_SCOPES')
    // => { "access_token": "...", "expires_in": 900, ... }

    axios.get(API_ENDPOINT, 
      headers: {
        Authorization: `Bearer ${auth.access_token}`
      }
    )

INFO

Always add your Subscription key to the request.

js
axios.get(API_ENDPOINT, 
  headers: {
    'Ocp-Apim-Subscription-Key': 'd484a1f0d34f43019'
  }
)
axios.get(API_ENDPOINT, 
  headers: {
    'Ocp-Apim-Subscription-Key': 'd484a1f0d34f43019'
  }
)
js
const res = await axios.get(API_ENDPOINT, { 
  params: { 
    Ocp-Apim-Subscription-Key: 'd484a1f0d34f43019' 
  } 
});
const res = await axios.get(API_ENDPOINT, { 
  params: { 
    Ocp-Apim-Subscription-Key: 'd484a1f0d34f43019' 
  } 
});

Query Parameters

NameTypeRequiredDescription
vstringnoThe API Version

Header Parameters

NameTypeRequiredDescription
x-versionstringnoThe API Version
Bearerstring(JwtToken)noThe Token required for authorization

Response

Aml-Pep Screening Check

FieldTypeDescription
surnamestringSurname of the individual
givenNamestringGiven name or first name of the individual
otherNamesstring or nullOther names or middle names of the individual
genderstringGender of the individual (e.g., Male, Female)
dateOfBirthstringDate of birth of the individual
responsearray of objectsArray containing details of the screening response
errorCodestring or nullError code if there was an error during the screening
errorMessagestring or nullError message if there was an error during the screening
statusstringStatus of the screening check
processedAtstringTimestamp indicating when the check was processed
verifiedAtstringTimestamp indicating when the check was verified
idstringUnique identifier for the screening check
createdAtstringTimestamp indicating when the screening check was created

[] response

FieldTypeDescription
createdAtstringTimestamp indicating when the response was created
statusstringStatus of the response (e.g., Successful, Failed)
totalHitsintegerNumber of hits found during the screening
processedAtstringTimestamp indicating when the response was processed
optionstringType of screening performed (e.g., Aml, Pep)
detailsarrayArray containing additional details of the response
isErrorboolean or nullIndicates if there was an error during the response processing
errorsstring or nullError details if there was an error during the response

Photo Match Check

Details for the photo match check.

FieldTypeDescription
photoMatchScorestringScore indicating the match between photos
biometricTypestringType of biometric check performed
resultbooleanResult of the photo match check
biometricActionsarray of objectsArray containing details of biometric actions
errorCodestring or nullError code if there was an error during the check
errorMessagestring or nullError message if there was an error during the check
statusstringStatus of the photo match check
processedAtstringTimestamp indicating when the check was processed
verifiedAtstringTimestamp indicating when the check was verified
idstringUnique identifier for the photo match check
createdAtstringTimestamp indicating when the photo match check was created
lastUpdatedstringTimestamp indicating when the photo match check was last updated

[] biometricActions

FieldTypeDescription
idstringUnique identifier for the biometric action
typestringType of biometric action performed
resultbooleanResult of the biometric action
commentstringComment related to the biometric action
performedBystringName of the person who performed the biometric action
performedByIdstringUnique identifier of the person who performed the action
createdAtstringTimestamp indicating when the biometric action was created
lastUpdatedstringTimestamp indicating when the biometric action was last updated

Liveness Detection Check

Details for the liveness detection check.

FieldTypeDescription
livenessScorestringScore indicating the liveness of the individual
numberOfFramesintegerNumber of frames used in the liveness detection
biometricTypestringType of biometric check performed
resultbooleanResult of the liveness detection check
biometricActionsarray of objectsArray containing details of biometric actions
errorCodestring or nullError code if there was an error during the check
errorMessagestring or nullError message if there was an error during the check
statusstringStatus of the liveness detection check
processedAtstringTimestamp indicating when the check was processed
verifiedAtstringTimestamp indicating when the check was verified
idstringUnique identifier for the liveness detection check
createdAtstringTimestamp indicating when the liveness detection check was created
lastUpdatedstringTimestamp indicating when the liveness detection check was last updated

Biometric Actions

FieldTypeDescription
idstringUnique identifier for the biometric action
typestringType of biometric action performed
resultbooleanResult of the biometric action
commentstringComment related to the biometric action
performedBystringName of the person who performed the biometric action
performedByIdstringUnique identifier of the person who performed the action
createdAtstringTimestamp indicating when the biometric action was created
lastUpdatedstringTimestamp indicating when the biometric action was last updated

Identity Document Checks

Details for the identity document checks.

FieldTypeDescription
idTypestringType of identification document
idNumberstringIdentification number of the document
documentNumberstringDocument number associated with the identification
countrystringCountry of issuance
dateOfBirthstringDate of birth of the individual
dateOfIssuestring or nullDate of issue of the document
dateOfExpirystringExpiry date of the document
surnamestringSurname of the individual
givenNamesstringGiven names of the individual
otherNamesstring or nullOther names of the individual
requiresValidationbooleanIndicates if the document requires validation
responseobjectDetails of the document verification response
errorCodestring or nullError code if there was an error during the check
errorMessagestring or nullError message if there was an error during the check
statusstringStatus of the document check
processedAtstringTimestamp indicating when the check was processed
verifiedAtstringTimestamp indicating when the check was verified
idstringUnique identifier for the document check
createdAtstringTimestamp indicating when the document check was created
lastUpdatedstringTimestamp indicating when the document check was last updated

[] response

FieldTypeDescription
idstringUnique identifier for the response
participantIdstring or nullUnique identifier for the participant
receivedAtstringTimestamp indicating when the response was received
submittedAtstringTimestamp indicating when the response was submitted
receivedFromNirastringTimestamp indicating when the response was received from NIRA
requestStatusstringStatus of the request
surnamestringSurname of the individual
givenNamesstringGiven names of the individual
otherNamesstring or nullOther names of the individual
cardNumberstringCard number of the individual
maskedCardNumberstringMasked card number of the individual
ninstringNational Identification Number
maskedNinstringMasked National Identification Number
multipleReferenceIdstring or nullMultiple reference identifier
dateOfBirthstringDate of birth of the individual
resultJsonobjectJSON object containing the result of the check

{} resultJson

FieldTypeDescription
matchingStatusbooleanIndicates if the document details (Surname, Given Names, Date of birth) match NIRA records
cardStatusstringStatus of the card
statusstringStatus of the check
errorstring or nullError details if there was an error during the check

Example Response Body

Content type

application/json

json
{
    "amlPepScreeningCheck": {
        "surname": "KAGGWA",
        "givenName": "JOHN",
        "otherNames": "PETER",
        "gender": "M",
        "dateOfBirth": "1985-06-15T00:00:00",
        "response": [
            {
                "createdAt": "2024-08-08T10:09:14.734963Z",
                "status": "Successful",
                "totalHits": 0,
                "processedAt": "2024-08-08T13:09:15.891019+03:00",
                "option": "Aml",
                "details": [],
                "isError": null,
                "errors": null
            },
            {
                "createdAt": "2024-08-08T10:09:14.734963Z",
                "status": "Successful",
                "totalHits": 0,
                "processedAt": "2024-08-08T13:09:15.891019+03:00",
                "option": "Pep",
                "details": [],
                "isError": null,
                "errors": null
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": "2024-08-08T13:09:14.359185+03:00",
        "verifiedAt": "2024-08-08T13:09:16.160686+03:00",
        "id": "9b8b5f62-e3f7-4d2d-8c5d-1a2e6b7b9f9a",
        "createdAt": "2024-08-08T13:09:11.182305+03:00",
        "lastUpdated": "2024-08-08T13:09:16.160686+03:00"
    },
    "companyAmlScreeningCheck": null,
    "photoMatchCheck": {
        "photoMatchScore": "0.7825314",
        "biometricType": "PhotoMatch",
        "result": true,
        "biometricActions": [
            {
                "id": "8a9e6b27-d5b4-4f0e-8e5a-9f7e7d5a9b6a",
                "type": "override",
                "result": false,
                "comment": "Customer mismatch",
                "performedBy": "Daniel Okello",
                "performedById": "5b8e6f77-1c4d-4cb7-8421-67e3e2973810",
                "createdAt": "2024-07-12T22:02:34.623079+03:00",
                "lastUpdated": "2024-07-12T22:02:34.62308+03:00"
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": "2024-08-08T16:08:48+03:00",
        "verifiedAt": "2024-08-08T16:08:48+03:00",
        "id": "3c6e2d9b-f7d5-4e6e-8e2d-7b8f7e5d7a9b",
        "createdAt": "2024-08-08T13:09:11.230275+03:00",
        "lastUpdated": "2024-07-12T22:02:34.623081+03:00"
    },
    "livenessDetectionCheck": {
        "livenessScore": "0.99645321",
        "numberOfFrames": 1,
        "biometricType": "LivenessDetection",
        "result": true,
        "biometricActions": [
            {
                "id": "4e6a5f33-2b5d-4a5e-8e5a-4a5b7d5a9b6a",
                "type": "override",
                "result": false,
                "comment": "Customer is fake",
                "performedBy": "Daniel Okello",
                "performedById": "5b8e6f77-1c4d-4cb7-8421-67e3e2973810",
                "createdAt": "2024-07-12T22:02:22.71781+03:00",
                "lastUpdated": "2024-07-12T22:02:22.717811+03:00"
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": "2024-08-08T16:08:48+03:00",
        "verifiedAt": "2024-08-08T16:08:48+03:00",
        "id": "9c8d7e6f-4a5e-4b5d-8e5a-7d5b7d5a9b6a",
        "createdAt": "2024-08-08T13:09:11.248392+03:00",
        "lastUpdated": "2024-07-12T22:02:22.717811+03:00"
    },
    "fingerprintCheck": null,
    "businessNameCheck": null,
    "identityDocumentChecks": [
        {
            "idType": "Nationalid",
            "idNumber": "CF87036100PJKL",
            "documentNumber": "007651234",
            "country": "Uganda",
            "dateOfBirth": "1985-06-15T00:00:00",
            "dateOfIssue": "2015-06-15T00:00:00",
            "dateOfExpiry": "2025-06-15T00:00:00",
            "surname": "KAGGWA",
            "givenNames": "JOHN PETER",
            "otherNames": "",
            "requiresValidation": false,
            "response": {
                "id": "9e6f7d5a-4b5d-4a5e-8e5a-4a5b7d5a9b6a",
                "participantId": null,
                "receivedAt": "2024-08-08T13:09:14.3339273",
                "submittedAt": "2024-08-08T13:09:14.4936214Z",
                "receivedFromNira": "2024-08-08T13:09:14.8165861Z",
                "requestStatus": "Completed",
                "surname": "KAGGWA",
                "givenNames": "JOHN PETER",
                "otherNames": "",
                "cardNumber": "007651234",
                "maskedCardNumber": "00765****",
                "nin": "CF87036100PJKL",
                "maskedNin": "CF8703********",
                "multipleReferenceId": null,
                "dateOfBirth": "1985-06-15T00:00:00",
                "resultJson": {
                    "matchingStatus": true,
                    "cardStatus": "Valid",
                    "status": "Ok",
                    "error": null,
                    "isError": false,
                    "ninStatus": "Ok"
                }
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Successful",
            "processedAt": "2024-08-08T13:09:14.321421+03:00",
            "verifiedAt": "2024-08-08T13:09:14.960204+03:00",
            "id": "4d6e7a5d-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.161489+03:00",
            "lastUpdated": "2024-08-08T13:09:14.960205+03:00"
        }
    ],
    "kccaLicenceChecks": [],
    "phoneNumberChecks": [
        {
            "value": "+256704567890",
            "nationalIdNumber": "CF87036100PJKL",
            "vendorCode": "STRM_01",
            "country": "Uganda",
            "response": {
                "createdAt": "2024-08-08T10:09:25.768812Z",
                "status": "Completed",
                "verificationStatus": "Valid",
                "phoneNumber": "256704567890",
                "sentAt": "2024-08-08T13:09:25.7688123+03:00",
                "responsePayload": "{\"Name\":\"JOHN KAGGWA\",\"Network\":\"MTN\",\"Status\":1}",
                "processedAt": "2024-08-08T13:09:27.6775565+03:00",
                "nameFound": "JOHN KAGGWA",
                "network": "MTN",
                "phoneNumberStatus": true,
                "errorCode": null,
                "errorMessage": null,
                "isError": null,
                "errors": null,
                "vendorCode": "STRM_01",
                "isPhoneNumberValid": null,
                "isOwner": null,
                "lastSimSwapDate": null
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Successful",
            "processedAt": "2024-08-08T13:09:14.339972+03:00",
            "verifiedAt": "2024-08-08T13:09:28.571369+03:00",
            "id": "6a7e8f9b-2b5d-4a5e-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.171449+03:00",
            "lastUpdated": "2024-08-08T13:09:28.571369+03:00"
        },
        {
            "value": "+256704567890",
            "nationalIdNumber": "CF87036100PJKL",
            "vendorCode": "STRM_02",
            "country": "Uganda",
            "response": {
                "createdAt": "2024-08-08T10:09:14.3509363Z",
                "status": "Completed",
                "verificationStatus": "Valid",
                "phoneNumber": "256704567890",
                "sentAt": "2024-08-08T13:09:14.3509365+03:00",
                "responsePayload": "{\"KycCheck\":{\"StatusMessage\":\"Success.\",\"Data\":{\"PhoneNumber\":\"256704567890\",\"IsPhoneNumberValid\":true,\"NationalIdNumber\":\"CF87036100PJKL\",\"IsOwner\":true},\"SentAt\":\"2024-08-08T10:09:16.156623Z\",\"ProcessedAt\":\"2024-08-08T10:09:15.4855567Z\",\"Initiator\":\"streamline_PhoneId_API\",\"Id\":\"e0254b4a-ae7b-4e77-b0dc-08dc5ae6f68d\",\"CreatedAt\":\"2024-08-08T13:09:15.4853645Z\"},\"SimSwapCheck\":{\"StatusMessage\":\"Success\",\"Data\":{\"LastSimSwapDate\":\"2017-07-04T15:53:46+03:00\"},\"SentAt\":\"2024-08-08T10:09:21.6552174Z\",\"ProcessedAt\":\"2024-08-08T10:09:21.4557791Z\",\"Initiator\":\"streamline_PhoneId_API\",\"Id\":\"88ac8e54-a8fe-4a1c-01dd-08dc5ae6fb95\",\"CreatedAt\":\"2024-08-08T13:09:21.4557781Z\"},\"Status\":1}",
                "processedAt": "2024-08-08T13:09:25.5352764+03:00",
                "nameFound": null,
                "network": null,
                "phoneNumberStatus": null,
                "errorCode": null,
                "errorMessage": null,
                "isError": null,
                "errors": null,
                "vendorCode": "STRM_02",
                "isPhoneNumberValid": true,
                "isOwner": true,
                "lastSimSwapDate": "2017-07-04T15:53:46+03:00"
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Successful",
            "processedAt": "2024-08-08T13:09:14.330482+03:00",
            "verifiedAt": "2024-08-08T13:09:25.746302+03:00",
            "id": "7b8f9d5a-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.169455+03:00",
            "lastUpdated": "2024-08-08T13:09:25.746302+03:00"
        }
    ],
     "tinChecks": [
        {
            "number": "0201456789",
            "country": "Uganda",
            "response": {
                "tin": "0201456789",
                "errorCode": "E004",
                "errorDescription": "INVALID TIN",
                "initiator": "JOHN KAGGWA",
                "contactNumber": null,
                "county": null,
                "district": null,
                "isCustomsAgent": null,
                "isLicenseValid": "Not applicable",
                "licenseNumber": null,
                "mobileNumber": null,
                "postalAddress": null,
                "registrationStatus": null,
                "subCounty": null,
                "taxPayerEmail": null,
                "taxPayerName": null,
                "telephoneNumber": null,
                "typeofUser": null,
                "village": "Not applicable",
                "nitaFaultCode": "Not applicable",
                "nitaFaultMessage": "Not applicable",
                "nitaFaultDescription": "Not applicable",
                "nitaFaultAms": "Not applicable",
                "nitaFaultText": "Not applicable",
                "status": "Failed",
                "isError": false,
                "errors": null,
                "sentAt": "2024-08-08T10:09:14.7604114",
                "processedAt": "2024-08-08T10:09:14.4718832",
                "createdAt": "2024-08-08T10:09:14.4718819",
                "lastUpdated": "2024-08-08T10:09:17.7246633"
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Failed",
            "processedAt": "2024-08-08T13:09:14.349599+03:00",
            "verifiedAt": "2024-08-08T13:09:19.112599+03:00",
            "id": "8c9d7e5a-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.180203+03:00",
            "lastUpdated": "2024-08-08T13:09:19.112599+03:00"
        }
    ],
    "riskProfileCheck": {
        "nationality": "Uganda",
        "occupation": "Engineer",
        "district": "KAMPALA",
        "monthlyIncome": "UGX 3 million - UGX 5 million",
        "usePhoneNumber": false,
        "useTin": false,
        "usePep": true,
        "useIdentityDocument": false,
        "response": {
            "riskScore": 1.75,
            "riskClass": "Moderate",
            "processedAt": "2024-08-08T13:09:28.009206+03:00",
            "status": "Processed",
            "computedRiskRatings": [
                {
                    "score": 1.0,
                    "riskFactor": "District"
                },
                {
                    "score": 1.0,
                    "riskFactor": "PepStatus"
                },
                {
                    "score": 0.0,
                    "riskFactor": "Occupation"
                },
                {
                    "score": 0.5,
                    "riskFactor": "Nationality"
                },
                {
                    "score": 2.0,
                    "riskFactor": "MonthlyIncome"
                }
            ],
            "id": "5f7e8d9b-2b5d-4a5e-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:21.404645+03:00"
        },
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": null,
        "verifiedAt": "2024-08-08T13:09:29.614239+03:00",
        "id": "6a7e8d5a-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
        "createdAt": "2024-08-08T13:09:11.209552+03:00",
        "lastUpdated": "2024-08-08T13:09:29.61424+03:00"
    }
{
    "amlPepScreeningCheck": {
        "surname": "KAGGWA",
        "givenName": "JOHN",
        "otherNames": "PETER",
        "gender": "M",
        "dateOfBirth": "1985-06-15T00:00:00",
        "response": [
            {
                "createdAt": "2024-08-08T10:09:14.734963Z",
                "status": "Successful",
                "totalHits": 0,
                "processedAt": "2024-08-08T13:09:15.891019+03:00",
                "option": "Aml",
                "details": [],
                "isError": null,
                "errors": null
            },
            {
                "createdAt": "2024-08-08T10:09:14.734963Z",
                "status": "Successful",
                "totalHits": 0,
                "processedAt": "2024-08-08T13:09:15.891019+03:00",
                "option": "Pep",
                "details": [],
                "isError": null,
                "errors": null
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": "2024-08-08T13:09:14.359185+03:00",
        "verifiedAt": "2024-08-08T13:09:16.160686+03:00",
        "id": "9b8b5f62-e3f7-4d2d-8c5d-1a2e6b7b9f9a",
        "createdAt": "2024-08-08T13:09:11.182305+03:00",
        "lastUpdated": "2024-08-08T13:09:16.160686+03:00"
    },
    "companyAmlScreeningCheck": null,
    "photoMatchCheck": {
        "photoMatchScore": "0.7825314",
        "biometricType": "PhotoMatch",
        "result": true,
        "biometricActions": [
            {
                "id": "8a9e6b27-d5b4-4f0e-8e5a-9f7e7d5a9b6a",
                "type": "override",
                "result": false,
                "comment": "Customer mismatch",
                "performedBy": "Daniel Okello",
                "performedById": "5b8e6f77-1c4d-4cb7-8421-67e3e2973810",
                "createdAt": "2024-07-12T22:02:34.623079+03:00",
                "lastUpdated": "2024-07-12T22:02:34.62308+03:00"
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": "2024-08-08T16:08:48+03:00",
        "verifiedAt": "2024-08-08T16:08:48+03:00",
        "id": "3c6e2d9b-f7d5-4e6e-8e2d-7b8f7e5d7a9b",
        "createdAt": "2024-08-08T13:09:11.230275+03:00",
        "lastUpdated": "2024-07-12T22:02:34.623081+03:00"
    },
    "livenessDetectionCheck": {
        "livenessScore": "0.99645321",
        "numberOfFrames": 1,
        "biometricType": "LivenessDetection",
        "result": true,
        "biometricActions": [
            {
                "id": "4e6a5f33-2b5d-4a5e-8e5a-4a5b7d5a9b6a",
                "type": "override",
                "result": false,
                "comment": "Customer is fake",
                "performedBy": "Daniel Okello",
                "performedById": "5b8e6f77-1c4d-4cb7-8421-67e3e2973810",
                "createdAt": "2024-07-12T22:02:22.71781+03:00",
                "lastUpdated": "2024-07-12T22:02:22.717811+03:00"
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": "2024-08-08T16:08:48+03:00",
        "verifiedAt": "2024-08-08T16:08:48+03:00",
        "id": "9c8d7e6f-4a5e-4b5d-8e5a-7d5b7d5a9b6a",
        "createdAt": "2024-08-08T13:09:11.248392+03:00",
        "lastUpdated": "2024-07-12T22:02:22.717811+03:00"
    },
    "fingerprintCheck": null,
    "businessNameCheck": null,
    "identityDocumentChecks": [
        {
            "idType": "Nationalid",
            "idNumber": "CF87036100PJKL",
            "documentNumber": "007651234",
            "country": "Uganda",
            "dateOfBirth": "1985-06-15T00:00:00",
            "dateOfIssue": "2015-06-15T00:00:00",
            "dateOfExpiry": "2025-06-15T00:00:00",
            "surname": "KAGGWA",
            "givenNames": "JOHN PETER",
            "otherNames": "",
            "requiresValidation": false,
            "response": {
                "id": "9e6f7d5a-4b5d-4a5e-8e5a-4a5b7d5a9b6a",
                "participantId": null,
                "receivedAt": "2024-08-08T13:09:14.3339273",
                "submittedAt": "2024-08-08T13:09:14.4936214Z",
                "receivedFromNira": "2024-08-08T13:09:14.8165861Z",
                "requestStatus": "Completed",
                "surname": "KAGGWA",
                "givenNames": "JOHN PETER",
                "otherNames": "",
                "cardNumber": "007651234",
                "maskedCardNumber": "00765****",
                "nin": "CF87036100PJKL",
                "maskedNin": "CF8703********",
                "multipleReferenceId": null,
                "dateOfBirth": "1985-06-15T00:00:00",
                "resultJson": {
                    "matchingStatus": true,
                    "cardStatus": "Valid",
                    "status": "Ok",
                    "error": null,
                    "isError": false,
                    "ninStatus": "Ok"
                }
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Successful",
            "processedAt": "2024-08-08T13:09:14.321421+03:00",
            "verifiedAt": "2024-08-08T13:09:14.960204+03:00",
            "id": "4d6e7a5d-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.161489+03:00",
            "lastUpdated": "2024-08-08T13:09:14.960205+03:00"
        }
    ],
    "kccaLicenceChecks": [],
    "phoneNumberChecks": [
        {
            "value": "+256704567890",
            "nationalIdNumber": "CF87036100PJKL",
            "vendorCode": "STRM_01",
            "country": "Uganda",
            "response": {
                "createdAt": "2024-08-08T10:09:25.768812Z",
                "status": "Completed",
                "verificationStatus": "Valid",
                "phoneNumber": "256704567890",
                "sentAt": "2024-08-08T13:09:25.7688123+03:00",
                "responsePayload": "{\"Name\":\"JOHN KAGGWA\",\"Network\":\"MTN\",\"Status\":1}",
                "processedAt": "2024-08-08T13:09:27.6775565+03:00",
                "nameFound": "JOHN KAGGWA",
                "network": "MTN",
                "phoneNumberStatus": true,
                "errorCode": null,
                "errorMessage": null,
                "isError": null,
                "errors": null,
                "vendorCode": "STRM_01",
                "isPhoneNumberValid": null,
                "isOwner": null,
                "lastSimSwapDate": null
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Successful",
            "processedAt": "2024-08-08T13:09:14.339972+03:00",
            "verifiedAt": "2024-08-08T13:09:28.571369+03:00",
            "id": "6a7e8f9b-2b5d-4a5e-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.171449+03:00",
            "lastUpdated": "2024-08-08T13:09:28.571369+03:00"
        },
        {
            "value": "+256704567890",
            "nationalIdNumber": "CF87036100PJKL",
            "vendorCode": "STRM_02",
            "country": "Uganda",
            "response": {
                "createdAt": "2024-08-08T10:09:14.3509363Z",
                "status": "Completed",
                "verificationStatus": "Valid",
                "phoneNumber": "256704567890",
                "sentAt": "2024-08-08T13:09:14.3509365+03:00",
                "responsePayload": "{\"KycCheck\":{\"StatusMessage\":\"Success.\",\"Data\":{\"PhoneNumber\":\"256704567890\",\"IsPhoneNumberValid\":true,\"NationalIdNumber\":\"CF87036100PJKL\",\"IsOwner\":true},\"SentAt\":\"2024-08-08T10:09:16.156623Z\",\"ProcessedAt\":\"2024-08-08T10:09:15.4855567Z\",\"Initiator\":\"streamline_PhoneId_API\",\"Id\":\"e0254b4a-ae7b-4e77-b0dc-08dc5ae6f68d\",\"CreatedAt\":\"2024-08-08T13:09:15.4853645Z\"},\"SimSwapCheck\":{\"StatusMessage\":\"Success\",\"Data\":{\"LastSimSwapDate\":\"2017-07-04T15:53:46+03:00\"},\"SentAt\":\"2024-08-08T10:09:21.6552174Z\",\"ProcessedAt\":\"2024-08-08T10:09:21.4557791Z\",\"Initiator\":\"streamline_PhoneId_API\",\"Id\":\"88ac8e54-a8fe-4a1c-01dd-08dc5ae6fb95\",\"CreatedAt\":\"2024-08-08T13:09:21.4557781Z\"},\"Status\":1}",
                "processedAt": "2024-08-08T13:09:25.5352764+03:00",
                "nameFound": null,
                "network": null,
                "phoneNumberStatus": null,
                "errorCode": null,
                "errorMessage": null,
                "isError": null,
                "errors": null,
                "vendorCode": "STRM_02",
                "isPhoneNumberValid": true,
                "isOwner": true,
                "lastSimSwapDate": "2017-07-04T15:53:46+03:00"
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Successful",
            "processedAt": "2024-08-08T13:09:14.330482+03:00",
            "verifiedAt": "2024-08-08T13:09:25.746302+03:00",
            "id": "7b8f9d5a-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.169455+03:00",
            "lastUpdated": "2024-08-08T13:09:25.746302+03:00"
        }
    ],
     "tinChecks": [
        {
            "number": "0201456789",
            "country": "Uganda",
            "response": {
                "tin": "0201456789",
                "errorCode": "E004",
                "errorDescription": "INVALID TIN",
                "initiator": "JOHN KAGGWA",
                "contactNumber": null,
                "county": null,
                "district": null,
                "isCustomsAgent": null,
                "isLicenseValid": "Not applicable",
                "licenseNumber": null,
                "mobileNumber": null,
                "postalAddress": null,
                "registrationStatus": null,
                "subCounty": null,
                "taxPayerEmail": null,
                "taxPayerName": null,
                "telephoneNumber": null,
                "typeofUser": null,
                "village": "Not applicable",
                "nitaFaultCode": "Not applicable",
                "nitaFaultMessage": "Not applicable",
                "nitaFaultDescription": "Not applicable",
                "nitaFaultAms": "Not applicable",
                "nitaFaultText": "Not applicable",
                "status": "Failed",
                "isError": false,
                "errors": null,
                "sentAt": "2024-08-08T10:09:14.7604114",
                "processedAt": "2024-08-08T10:09:14.4718832",
                "createdAt": "2024-08-08T10:09:14.4718819",
                "lastUpdated": "2024-08-08T10:09:17.7246633"
            },
            "errorCode": null,
            "errorMessage": null,
            "status": "Failed",
            "processedAt": "2024-08-08T13:09:14.349599+03:00",
            "verifiedAt": "2024-08-08T13:09:19.112599+03:00",
            "id": "8c9d7e5a-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:11.180203+03:00",
            "lastUpdated": "2024-08-08T13:09:19.112599+03:00"
        }
    ],
    "riskProfileCheck": {
        "nationality": "Uganda",
        "occupation": "Engineer",
        "district": "KAMPALA",
        "monthlyIncome": "UGX 3 million - UGX 5 million",
        "usePhoneNumber": false,
        "useTin": false,
        "usePep": true,
        "useIdentityDocument": false,
        "response": {
            "riskScore": 1.75,
            "riskClass": "Moderate",
            "processedAt": "2024-08-08T13:09:28.009206+03:00",
            "status": "Processed",
            "computedRiskRatings": [
                {
                    "score": 1.0,
                    "riskFactor": "District"
                },
                {
                    "score": 1.0,
                    "riskFactor": "PepStatus"
                },
                {
                    "score": 0.0,
                    "riskFactor": "Occupation"
                },
                {
                    "score": 0.5,
                    "riskFactor": "Nationality"
                },
                {
                    "score": 2.0,
                    "riskFactor": "MonthlyIncome"
                }
            ],
            "id": "5f7e8d9b-2b5d-4a5e-8e5a-4a5b7d5a9b6a",
            "createdAt": "2024-08-08T13:09:21.404645+03:00"
        },
        "errorCode": null,
        "errorMessage": null,
        "status": "Successful",
        "processedAt": null,
        "verifiedAt": "2024-08-08T13:09:29.614239+03:00",
        "id": "6a7e8d5a-4a5e-4b5d-8e5a-4a5b7d5a9b6a",
        "createdAt": "2024-08-08T13:09:11.209552+03:00",
        "lastUpdated": "2024-08-08T13:09:29.61424+03:00"
    }

Error Response

400 The request data is invalid

application/json

NameTypeDescription
typestring or nullType of error response
titlestring or nullThe title of the error response
statusinteger(int32)The status of the error response
traceIdstring or nullThe traceId of the error request producing the error
errorsobjectObject defining the errors

errors

NameTypeDescription
propertyArray of stringsThe definition of the errors

401 Not authorized to access the endpoint

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

402 No active subscription

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

403 Refuse to authorize access to the endpoint

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

404 Request does not exist

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

500 The server encountered an unexpected error

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

Tech served right