BNC

A clean and simple Bruto Netto Calculator API by Fit Solutions

Example

Execute a HTTP POST to https://bnc.mijnkredietomgeving.nl/calculate with the request below.

Request


{
    "apiKey": "12345",
    "applicant": {
        "name": "Bob",
        "age": 36,
        "alimony": false,
        "grossIncome": 3500.00
    },
    "partner": {
        "name": "Susan",
        "age": 27,
        "alimony": false,
        "grossIncome": 1500.00
    }
}

Response


{
    "applicantNetIncome": 2549.47,
    "partnerNetIncome": 1454.03
}

Possible HTTP response codes

  • 200 - OK. Calculated response is returned
  • 400 - Bad request. Validation of request failed by schema
  • 401 - Authentication required. API Key was missing
  • 403 - Authentication failed. Invalid API Key supplied

This API uses json-schema to validate the incoming request. Checkout the schema here!

BNC Request
Parameter Type Required Description
apiKey string(34) true Unique API key to access this service
applicant Applicant true Main applicant
partner Applicant false Partner of applicant
BNC Response
Parameter Type Required Description
applicantNetIncome float true Calculated net income for main applicant
partnerNetIncome float false Calculated net income for partner
Applicant
Parameter Type Required Description
name string(80) false Name of this applicant. Min. 2, Max. 80
age integer true Age of this applicant. Min. 14, Max. 80
alimony boolean false true if applicant receives alimony, otherwise false
grossIncome float true Amount of gross income. Based on this value the net income will be calculated. Min. 1, Max. 50000