Sorry, you need to enable JavaScript to visit this website.

6 Home loans preapproval

Action

Using the Homeloans heavy access token you received in the heavy token call, and the reference data you received from the reference data call, build a form which the user will complete and then build up the request body below using that form data.


Method POST
Endpoint https://api.nedbank.co.za/apimarket/sandbox/nb-home-loans/api/open-banking/preapproval
Request
Headers
Header Value Description
Content-Type application/json The data type being sent to the endpoint
x-fapi-financial-id OB/2017/001 Financial ID
Authorization Bearer <ACCESS_TOKEN> The access token you received from the previous call. Replace <ACCESS_TOKEN> with the access token you received.
x-ibm-client-id <YOUR CLIENT ID> The client ID you received when creating the app on the portal.
x-ibm-client-secret <YOUR CLIENT SECRET> The client secret you received when creating the app on the portal.

Body JSON
                                
{
  "id": 1,
  "loanType": "1",
  "amountRequired": 900000,
  "reason": "1",
  "term": 20,
  "depositAmount": 100000,
  "agreedTerms": true,
  "applicants": [
    {
      "id": 1,
      "clientId": "1",
      "rsaIdNumber": "8303035024088",
      "fullNames": "John",
      "surname": "Johnson",
      "maritalStatus": "M",
      "mobileNumber": "",
      "email": "",
      "income": {
        "id": 1,
               "grossSalaryMonthly": 30000,
        "netSalaryMonthly": 25000,
        "otherIncome": 1000,
        "contractDebtMonthly": 1000,
        "expensesMonthly": 1000,
        "additionalProp1": {}
      },
      "marriageType": "01",
      "isMainApp": true,
      "isSpouse": false
    }
  ],
  "product": {
    "id": 1,
    "name": "New Loan",
    "code": "01",
    "description": "New Loan"
  },
  "purchasePrice": 1000000,
  "existingLoanAccNumber": "",
  "buildingContractCost": 0,
  "landPrice": 0,
  "loanOrigin": {
    "code": "01",
    "segment": "Retail",
    "area": "",
    "description": ""
  },
  "propertyUsage": "1"
}
                                
                                
Response JSON
                        
{
    "Status": "In Progress",
    "Intent Id": "02dcd85c-a1fb-417d-a0de-875b79ad56e6"
}