Skip to content
On this page

Get All Application

Endpoint for retrieving a list of customer onboarding applications.

Endpoints

EnvironmentAPI Endpoint
Sandboxhttps://onprem-test.streamline.laboremus.ug/api/onboarding/v1/applications

Request

Request Type : GET

Authorization

INFO

Always add your Subscription key to the request.

Query Parameters

NameTypeRequiredDescription
vstringyesThe version of the API
applicationIdstringnoThe Id of the application
customerNamestringnoThe name of the customer

Response

Content type

application/json

Response Body

Applications

NameTypeDescription
[]array of applicationsA List of applications.

Application

NameTypeDescription
idstring (uuid)A unique identifier for the record.
createdAtstring (ISO 8601 date-time)The timestamp when the record was created in ISO 8601 format.
applicationIdstring (uuid)A unique identifier for the application associated with this record.
tenantIdstring (uuid)A unique identifier for the tenant associated with this record.
aggregatorIdstring (uuid)A unique identifier for the aggregator associated with this record.
profileIdstring (uuid)A unique identifier for the profile associated with this record.
externalReferencestringAn external reference identifier for the record.
referenceNumberstringA unique reference number for tracking purposes.
applicationDatestring (ISO 8601 date-time)The date when the application was created in ISO 8601 format.
applicationSubmittedAtstring (ISO 8601 date-time)The date when the application was submitted in ISO 8601 format.
statusstringThe current status of the application (e.g., Received).
approvalRequestDatestring (ISO 8601 date-time)The date when the approval request was made in ISO 8601 format.
approvalDatestring (ISO 8601 date-time)The date when the application was approved in ISO 8601 format.
declineDatestring (ISO 8601 date-time)The date when the application was declined in ISO 8601 format.
channelstringThe channel through which the application was submitted.
checkStatusstringThe current status of the verification check (e.g., Pending).
applicationDataobjectAn object containing detailed information about the application data.
documentsarray of objectsAn array of documents associated with the application, each containing document details.
commentsarray of objectsAn array of comments related to the application, each containing comment details.

Application Data

NameTypeDescription
dateCreatedstring (datetime)The date when the application data was created.
createdAtstring (datetime)The creation timestamp of the record.
dateUpdatedstring (datetime)The date when the application data was last updated.
dateDeletedstring (datetime)The date when the application data was deleted.
createdBystringThe user or system that created the application data.
updatedBystringThe user or system that last updated the application data.
deletedBystringThe user or system that deleted the application data.
isDeletedbooleanIndicates whether the application data is marked as deleted.
lastUpdatedstring (datetime)The timestamp of the last update to the record.
idstring (uuid)A unique identifier for the application data.
channelstringThe channel through which the application was submitted.
accountNamestringThe name of the account associated with the application.
surnamestringThe surname of the applicant.
otherNamestringThe other name(s) of the applicant.
givenNamestringThe given name (first name) of the applicant.
fullNamestringThe full name of the applicant.
genderstringThe gender of the applicant.
dateOfBirthstringThe date of birth of the applicant.
maritalStatusstringThe marital status of the applicant.
districtstringThe district of residence of the applicant.
villagestringThe village of residence of the applicant.
parishstringThe parish of residence of the applicant.
occupationstringThe occupation of the applicant.
monthlyIncomestringThe monthly income of the applicant.
currencystringThe currency in which the income is measured.
accountTypestringThe type of account associated with the application.
alternativeMobileMoneyNumberstringThe alternative mobile money number of the applicant.
tinstringThe Tax Identification Number (TIN) of the applicant.
phoneNumberstringThe primary phone number of the applicant.
alternativePhoneNumberstringThe alternative phone number of the applicant.
alternativeAccountTypestringThe type of alternative account.
alternativeBankAccountNumberstringThe alternative bank account number.
alternativeBankNamestringThe name of the alternative bank.
cardNumberstringThe card number associated with the application.
ninstringThe National Identification Number (NIN) of the applicant.
expiryDatestring (datetime)The expiry date of the document provided by the applicant.
issueDatestring (datetime)The issue date of the document provided by the applicant.
submittedBy.idstring (uuid)A unique identifier for the submitting entity.
submittedBy.tenantIdstringThe tenant ID of the submitting entity.
submittedBy.aggregatorIdstringThe aggregator ID of the submitting entity.
submittedBy.aggregatorNamestringThe name of the aggregator.
submittedBy.agentCodestringThe code identifying the agent submitting the application.
livenessStatusbooleanIndicates whether the liveness check was successful.
customerPhotoMatchStatusbooleanIndicates whether the customer's photo matched the records.
photoMatchScorestringThe score of the photo match, if applicable.
numberOfFramesintegerThe number of frames used for photo matching.
isPepbooleanIndicates whether the applicant is a Politically Exposed Person (PEP).
pepTypestringThe type of PEP, if applicable.
nextOfKinNamestringThe name of the applicant's next of kin.
nextOfKinPhoneNumberstringThe phone number of the applicant's next of kin.
nationalitystringThe nationality of the applicant.
memberOrAssociateDetails[].idstring (uuid)A unique identifier for the member or associate.
memberOrAssociateDetails[].applicationDataIdstring (uuid)A unique identifier for the associated application data.
memberOrAssociateDetails[].surnamestringThe surname of the member or associate.
memberOrAssociateDetails[].givenNamestringThe given name of the member or associate.
memberOrAssociateDetails[].relationshipstringThe relationship of the member or associate to the applicant.

Submitted By

NameTypeDescription
idstring (uuid)A unique identifier for the entity or record.
tenantIdstringA unique identifier for the tenant.
aggregatorIdstringA unique identifier for the aggregator associated with the record.
aggregatorNamestringThe name of the aggregator.
agentCodestringA unique code identifying the agent involved.

Member Or Associate Details

NameTypeDescription
idstring (uuid)A unique identifier for the member or associate.
applicationDataIdstring (uuid)A unique identifier for the associated application data.
surnamestringThe surname (last name) of the member or associate.
givenNamestringThe given name (first name) of the member or associate.
relationshipstringThe relationship between the member/associate and the applicant.

Documents

NameTypeDescription
dateCreatedstring (ISO 8601 date-time)The date and time when the document was created.
createdAtstring (ISO 8601 date-time)The timestamp of when the document was officially recorded in the system.
dateUpdatedstring (ISO 8601 date-time)The timestamp of when the document was last updated.
dateDeletedstring (ISO 8601 date-time)The timestamp of when the document was deleted.
createdBystringThe user or process that created the document.
updatedBystringThe user or process that last updated the document.
deletedBystringThe user or process that deleted the document.
isDeletedbooleanIndicates whether the document has been deleted.
lastUpdatedstring (ISO 8601 date-time)The timestamp of when the document was most recently updated, regardless of other timestamps.
idstring (uuid)A unique identifier for the document.
namestringThe name of the document.
documentTypestringThe type of document (e.g., PDF, JPEG, etc.).
contentTypestringThe MIME type of the document (e.g., application/pdf, image/jpeg).
descriptionstringA brief description of the document's contents.
sizestringThe size of the document (e.g., in bytes or MB).
referencestringA reference identifier for the document.

Comments

NameTypeDescription
applicationIdstring (uuid)A unique identifier for the application.
actionstringThe action taken (e.g., "Approve", "Reject", etc.).
commentstringAny additional comments or notes related to the action.
tenantIdstring (uuid)A unique identifier for the tenant.
initiatorIdstring (uuid)A unique identifier for the person who initiated the action.
initiatorNamestringThe name of the person who initiated the action.
createdAtstring (ISO 8601 date-time)The timestamp when the action or comment was created.

Example Response Body

json
[
    {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "createdAt": "2024-09-30T13:39:27.057Z",
        "applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "aggregatorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "profileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "externalReference": "string",
        "referenceNumber": "string",
        "applicationDate": "2024-09-30T13:39:27.057Z",
        "applicationSubmittedAt": "2024-09-30T13:39:27.057Z",
        "status": "Received",
        "approvalRequestDate": "2024-09-30T13:39:27.057Z",
        "approvalDate": "2024-09-30T13:39:27.057Z",
        "declineDate": "2024-09-30T13:39:27.057Z",
        "channel": "string",
        "checkStatus": "Pending",
        "applicationData": {
            "dateCreated": "2024-09-30T13:39:27.057Z",
            "createdAt": "2024-09-30T13:39:27.057Z",
            "dateUpdated": "2024-09-30T13:39:27.057Z",
            "dateDeleted": "2024-09-30T13:39:27.057Z",
            "createdBy": "string",
            "updatedBy": "string",
            "deletedBy": "string",
            "isDeleted": true,
            "lastUpdated": "2024-09-30T13:39:27.057Z",
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "channel": "string",
            "accountName": "string",
            "surname": "string",
            "otherName": "string",
            "givenName": "string",
            "fullName": "string",
            "gender": "string",
            "dateOfBirth": "string",
            "maritalStatus": "string",
            "district": "string",
            "village": "string",
            "parish": "string",
            "occupation": "string",
            "monthlyIncome": "string",
            "currency": "string",
            "accountType": "string",
            "alternativeMobileMoneyNumber": "string",
            "tin": "string",
            "phoneNumber": "string",
            "alternativePhoneNumber": "string",
            "alternativeAccountType": "string",
            "alternativeBankAccountNumber": "string",
            "alternativeBankName": "string",
            "cardNumber": "string",
            "nin": "string",
            "expiryDate": "string",
            "issueDate": "string",
            "submittedBy": {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantId": "string",
            "aggregatorId": "string",
            "aggregatorName": "string",
            "agentCode": "string"
            },
            "livenessStatus": true,
            "customerPhotoMatchStatus": true,
            "photoMatchScore": "string",
            "numberOfFrames": 0,
            "isPep": true,
            "pepType": "string",
            "nextOfKinName": "string",
            "nextOfKinPhoneNumber": "string",
            "nationality": "string",
            "memberOrAssociateDetails": [
            {
                "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                "applicationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                "surname": "string",
                "givenName": "string",
                "relationship": "string"
            }
            ]
        },
        "documents": [
            {
            "dateCreated": "2024-09-30T13:39:27.057Z",
            "createdAt": "2024-09-30T13:39:27.057Z",
            "dateUpdated": "2024-09-30T13:39:27.057Z",
            "dateDeleted": "2024-09-30T13:39:27.057Z",
            "createdBy": "string",
            "updatedBy": "string",
            "deletedBy": "string",
            "isDeleted": true,
            "lastUpdated": "2024-09-30T13:39:27.057Z",
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "documentType": "string",
            "contentType": "string",
            "description": "string",
            "size": "string",
            "reference": "string"
            }
        ],
        "comments": [
            {
            "applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "action": "string",
            "comment": "string",
            "tenantId": "string",
            "initiatorId": "string",
            "initiatorName": "string",
            "createdAt": "2024-09-30T13:39:27.057Z"
            }
        ]
    }
]
[
    {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "createdAt": "2024-09-30T13:39:27.057Z",
        "applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "aggregatorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "profileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "externalReference": "string",
        "referenceNumber": "string",
        "applicationDate": "2024-09-30T13:39:27.057Z",
        "applicationSubmittedAt": "2024-09-30T13:39:27.057Z",
        "status": "Received",
        "approvalRequestDate": "2024-09-30T13:39:27.057Z",
        "approvalDate": "2024-09-30T13:39:27.057Z",
        "declineDate": "2024-09-30T13:39:27.057Z",
        "channel": "string",
        "checkStatus": "Pending",
        "applicationData": {
            "dateCreated": "2024-09-30T13:39:27.057Z",
            "createdAt": "2024-09-30T13:39:27.057Z",
            "dateUpdated": "2024-09-30T13:39:27.057Z",
            "dateDeleted": "2024-09-30T13:39:27.057Z",
            "createdBy": "string",
            "updatedBy": "string",
            "deletedBy": "string",
            "isDeleted": true,
            "lastUpdated": "2024-09-30T13:39:27.057Z",
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "channel": "string",
            "accountName": "string",
            "surname": "string",
            "otherName": "string",
            "givenName": "string",
            "fullName": "string",
            "gender": "string",
            "dateOfBirth": "string",
            "maritalStatus": "string",
            "district": "string",
            "village": "string",
            "parish": "string",
            "occupation": "string",
            "monthlyIncome": "string",
            "currency": "string",
            "accountType": "string",
            "alternativeMobileMoneyNumber": "string",
            "tin": "string",
            "phoneNumber": "string",
            "alternativePhoneNumber": "string",
            "alternativeAccountType": "string",
            "alternativeBankAccountNumber": "string",
            "alternativeBankName": "string",
            "cardNumber": "string",
            "nin": "string",
            "expiryDate": "string",
            "issueDate": "string",
            "submittedBy": {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantId": "string",
            "aggregatorId": "string",
            "aggregatorName": "string",
            "agentCode": "string"
            },
            "livenessStatus": true,
            "customerPhotoMatchStatus": true,
            "photoMatchScore": "string",
            "numberOfFrames": 0,
            "isPep": true,
            "pepType": "string",
            "nextOfKinName": "string",
            "nextOfKinPhoneNumber": "string",
            "nationality": "string",
            "memberOrAssociateDetails": [
            {
                "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                "applicationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                "surname": "string",
                "givenName": "string",
                "relationship": "string"
            }
            ]
        },
        "documents": [
            {
            "dateCreated": "2024-09-30T13:39:27.057Z",
            "createdAt": "2024-09-30T13:39:27.057Z",
            "dateUpdated": "2024-09-30T13:39:27.057Z",
            "dateDeleted": "2024-09-30T13:39:27.057Z",
            "createdBy": "string",
            "updatedBy": "string",
            "deletedBy": "string",
            "isDeleted": true,
            "lastUpdated": "2024-09-30T13:39:27.057Z",
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "documentType": "string",
            "contentType": "string",
            "description": "string",
            "size": "string",
            "reference": "string"
            }
        ],
        "comments": [
            {
            "applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "action": "string",
            "comment": "string",
            "tenantId": "string",
            "initiatorId": "string",
            "initiatorName": "string",
            "createdAt": "2024-09-30T13:39:27.057Z"
            }
        ]
    }
]

Error Response

400 Bad Request

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 Unauthorized

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

403 Forbidden

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

404 Not Found

application/json

NameTypeDescription
errorobject(Error)Type of error response

Error

NameTypeDescription
codestring or nullThe Error code
messagestring or nullThe Error message

500 Server 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