Get Enumerations

Current Account Onboarding - Monthly Income Enumeration

POST /staticData/getMonthlyIncomeEnumeration

<Use this endpoint to get the enumerations for Monthly Income, for current account onboarding scenario>

Parameters

Null

Response

00000

{
    "code": "00000",
    "msg": "Completed successfully",
    "requestId": "APPREQ00990320fed02000",
    "sender": "apigw.baas.choice",
    "locale": "en_KE",
    "timestamp": 1650533105687,
    "salt": "QcEwsZHMUr",
    "signature": "cdfd996e7e5ca655d3fa663db03abe63b852669f04e1f82fda9b473f606a11",
    "data": {
        "monthlyIncomeEnum": [
            {"id":"A", "text":"Less than 5000 ksh"},
            {"id":"B", "text":"5001 - 10000 ksh"},
            {"id":"C", "text":"10001 - 15000 ksh"},
            {"id":"D", "text":"15000 - 25000 ksh"},
            {"id":"E", "text":"Above 25000 ksh"}    
        ]
    }
}

Current Account Onboarding - Employ Status Enumeration

POST /staticData/getEmploymentEnumeration

<Use this endpoint to get the enumerations for employ status, for current account onboarding scenario>

Parameters

Null

Response

00000

{
    "code": "00000",
    "msg": "Completed successfully",
    "requestId": "APPREQ00990320fed02000",
    "sender": "apigw.baas.choice",
    "locale": "en_KE",
    "timestamp": 1650533105687,
    "salt": "QcEwsZHMUr",
    "signature": "cdfd996e7e5ca655d3fa663db03abe63b852669f04e1f82fda9b473f606a11",
    "data": {
        "employmentEnum": [
            {"id":"A", "text":"Employee"},
            {"id":"B", "text":"Self Employee"},
            {"id":"C", "text":"Unemployed"},
            {"id":"D", "text":"Employer"},
            {"id":"E", "text":"Student"},
            {"id":"F", "text":"Other"},
        ]
    }
}

Bank Code List

POST /staticData/getBankCodes

<Use this endpoint to get the enumerations for employ status, for current account onboarding scenario>

Parameters

Null

Response

00000

{
    "code": "00000",
    "msg": "Completed successfully",
    "requestId": "APPREQ00990320fed02000",
    "sender": "apigw.baas.choice",
    "locale": "en_KE",
    "timestamp": 1650533105687,
    "salt": "QcEwsZHMUr",
    "signature": "cdfd996e7e5ca655d3fa663db03abe63b852669f04e1f82fda9b473f606a11",
    "data": {
        "bankCodeList": [
            {"bankCode":"M-PESA", "bankName":"Mpesa"},
            {"bankCode":"CIC0001", "bankName":"TruuBank"},
            {"bankCode":"CIC0002", "bankName":"DigiTap"},
            {"bankCode":"CIC0003", "bankName":"TIFI"},
            {"bankCode":"01", "bankName":"Kenya Commercial Bank Limited "},
            {"bankCode":"46", "bankName":"Choice Microfinance Bank"},
        ]
    }
}

Query Operational Bank Account List

POST /staticData/getOperationalAccounts

This is for customers to get a list of the Choice bank accounts held in other commercial bank for different deposit/transfer demands, like FX, RTGS, EFT transfers.

Parameters

Name	Type	Description	Required?
type	wint	0 - Foreign Currency 1 - RTGS 2 - EFT	TRUE

Response

00000

"data": {
    "operationalBankAccounts": [
        {
            "bank": "Kingdom Bank", //bank name
            "branch": "Ongata Rongai", //branch
            "bankCode": "51", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "5021805188004", //account no.
            "currency": "USD",
            "swiftCode": "CIFIKENA" //swiftCode            
        },
        {
            "bank": "SBM Bank (Kenya) Limited", //bank name
            "branch": "Ongata Rongai", //branch
            "bankCode": "60", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "0322284570018", //account no.
            "currency": "USD",
            "swiftCode": "SBMKKENA" //swiftCode   
        }, 
        {
            "bank": "Diamond Trust Bank", //bank name
            "branch": "Karen", //branch
            "bankCode": "63", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "0217296003", //account no.
            "currency": "USD",
            "swiftCode": "DTKEKENA" //swiftCode
        }, 
        {
            "bank": "Middle East Bank", //bank name
            "branch": "Karen", //branch
            "bankCode": "18", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "1003036000523", //account no.
            "currency": "USD",
            "swiftCode": "MIEKKENA" //swiftCode
        }, 
        {
            "bank": "Equity Bank", //bank name
            "branch": "Kilimani", //branch
            "bankCode": "68", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "1450284300778", //account no.
            "currency": "USD",
            "swiftCode": "EQBLKENA" //swiftCode
        },
        {
            "bank": "Co-operative Bank of Kenya", //bank name
            "branch": "Ongata Rongai", //branch
            "bankCode": "11", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "02120214850701", //account no.
            "currency": "USD",
            "swiftCode": "KCOOKENA" //swiftCode
        }
    ]
}

Get Foreign Currency Cooperation Bank List

POST /staticData/getFcyCooperativeBanks

This is for customers to get a list of the Choice bank accounts held in other commercial bank for different deposit/transfer demands, like FX, RTGS, EFT transfers.

No Request Parameters for this interface.

Response

00000

"data": {
    "fcyCoopBanks": [
        {
            "bank": "Kingdom Bank", //bank name
            "branch": "Ongata Rongai", //branch
            "bankCode": "51", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "5021805188004", //account no.
            "currency": "USD",
            "swiftCode": "CIFIKENA" //swiftCode            
        },
        {
            "bank": "SBM Bank (Kenya) Limited", //bank name
            "branch": "Ongata Rongai", //branch
            "bankCode": "60", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "0322284570018", //account no.
            "currency": "USD",
            "swiftCode": "SBMKKENA" //swiftCode   
        }, 
        {
            "bank": "Diamond Trust Bank", //bank name
            "branch": "Karen", //branch
            "bankCode": "63", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "0217296003", //account no.
            "currency": "USD",
            "swiftCode": "DTKEKENA" //swiftCode
        }, 
        {
            "bank": "Middle East Bank", //bank name
            "branch": "Karen", //branch
            "bankCode": "18", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "1003036000523", //account no.
            "currency": "USD",
            "swiftCode": "MIEKKENA" //swiftCode
        }, 
        {
            "bank": "Equity Bank", //bank name
            "branch": "Kilimani", //branch
            "bankCode": "68", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "1450284300778", //account no.
            "currency": "USD",
            "swiftCode": "EQBLKENA" //swiftCode
        },
        {
            "bank": "Co-operative Bank of Kenya", //bank name
            "branch": "Ongata Rongai", //branch
            "bankCode": "11", //bank code
            "accountName": "Choice Microfinance Bank", //account name
            "accountNo": "02120214850701", //account no.
            "currency": "USD",
            "swiftCode": "KCOOKENA" //swiftCode
        }
    ]
}