# Lookup APIs

## Get Monthly Income List

<mark style="color:green;">`POST`</mark> `/staticData/getMonthlyIncomeEnumeration`

Use this endpoint to get the monthly income category list - useful for current account onboardings.&#x20;

**Response**

{% tabs %}
{% tab title="00000" %}

```json
{
    "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"}    
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Get Employment Status List

<mark style="color:green;">`POST`</mark> `/staticData/getEmploymentEnumeration`

Use this endpoint to get the employment status category list - useful for current account onboardings.&#x20;

**Response**

{% tabs %}
{% tab title="00000" %}

```json
{
    "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"},
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Get Bank Codes' List

<mark style="color:green;">`POST`</mark> `/staticData/getBankCodes`

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

**Response**

{% tabs %}
{% tab title="00000" %}

```json
{
    "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"},
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Get Operational Bank Accounts' List

<mark style="color:green;">`POST`</mark> `/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**

<table data-full-width="false"><thead><tr><th width="210">Name</th><th width="87">Type</th><th width="275.5335693359375">Description</th><th width="151.800048828125">Required?</th></tr></thead><tbody><tr><td><code>type</code></td><td>int</td><td>0 - Foreign Currency<br>1 - RTGS<br>2 - EFT</td><td>TRUE</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="00000" %}

```json
"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
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get Foreign Currency Cooperation Banks' List

<mark style="color:green;">`POST`</mark>  `/staticData/getFcyCooperativeBanks`

Use this API to get the list of the banks in which Choice Bank already holds FX accounts.&#x20;

**Response**

{% tabs %}
{% tab title="00000" %}

```json
"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
        }
    ]
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://choice-bank.gitbook.io/choice-bank/appendix/lookup-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.