New Business API

New Business

Value

Method

POST

URL

/newbusiness

The requirements for the request are set out in the BNP documentation, including field lengths and allowed values.

Some guidelines are provided below to help with constructing the request.

Optional Sections

Depending on the setup of the product and the value of the request the following sections may not be needed for personal line application for an individual.

  • Affordability
  • Marketing

Mapping Extensions

Provides a set of helpers for mapping from alternative input lists.

See Mapping Extensions

Complete Request Example

{
  "clientCode": "Provided by BNPP PF",
  "shopCode": "Provided by BNPP PF",
  "newBusinessRequestType": {
    "application": {
      "brokerReference": "BROKERREF01",
      "accountNumber": null,
      "insuranceType": 1,
      "isRenewal": false,
      "allowSearchAuthorisation": true,
      "isCustomerPresent": true,
      "hasCustomerDeclaration": true
    },
    "policy": {
      "policyInceptionDate": "2020-11-04",
      "policyRenewalDate": "2021-11-04",
      "totalCashPrice": 1320.00,
      "deposit": 132.00,
      "creditProductCode": "TIN1",
      "term": 10,
      "preferredPaymentDay": 15,
      "policyPremiumAmount": 132.00,
      "brokerCreditFeeAmount": 10.0,
      "brokerCreditFeeDescription": "fees",
      "brokerFeeAmount": 120.0,
      "brokerFeeAmountDescription": "discount applicable",
      "addOnAmount": 5.0,
      "addOnAmountDescription": "Heavy Duty",
      "discountAmount": 1.0,
      "discountAmountDescription": "Discount",
      "premiumDescription": "1",
      "policyType": 1,
      "policyNumber": "mh-123456",
      "insuranceCompany": "7",
      "ropRateType": 1,
      "isEdiFlag": false
    },
    "applicant": {
      "customer": {
        "title": "Mr",
        "firstName": "Test01FN",
        "lastName": "Test01LN",
        "dateOfBirth": "1966-10-09",
        "nationality": "GBR",
        "countryOfBirth": "GBR",
        "email": "[email protected]",
        "policyholderName": "MW FORREST",
        "address": {
          "houseName": null,
          "houseNumber": "1",
          "streetName": "CROMWELL ROAD",
          "townland": "ELY",
          "postTown": "ELY",
          "county": null,
          "postCode": "CB6 1AS",
          "addressLineOne": null
        },
        "yearsAtAddress": 2,
        "previousAddress": {
          "houseName": null,
          "houseNumber": "1",
          "streetName": "CROMWELL ROAD",
          "townland": "ELY",
          "postTown": "ELY",
          "county": null,
          "postCode": "CB6 1AS",
          "addressLineOne": null
        },
        "telephone": {
          "mobileNumber": "07700900624",
          "phoneNumber": "01632960183"
        },
        "employment": {
          "employmentStatusCDLCode": "Employee",
          "employmentStatus": "FT",
          "employmentLevel": false,
          "employmentAbiCode":null,
          "industrySector": "1",
          "employmentSector": "1"
        }
      },
      "payment": {
        "isJointAccount": false,
        "isApplicantAccount": true,
        "thirdPartyAccountName": null,
        "thirdPartyApplicantAddress": null
      },
      "bank": {
        "bankAccountNumber": "41011166",
        "bankSortCode": "201596",
        "iban": null,
        "bic": null
      },
      "marketing": {
        "isMarketingOptInEmail": false,
        "isMarketingOptInSms": false,
        "isMarketingOptInPost": false,
        "isMarketingOptInPhone": false
      },
      "income": {
        "netMonthlyIncome": 27800.00
      },
      "affordability": {
        "netMonthlyIncome": 27800.00,
        "spousePartnerNetMonthyIncome": 2000.0,
        "monthlyMortgageRentRepayment": 100.0,
        "maritalStatus": "M",
        "residentialStatus": "F",
        "numberOfDependants": 0
      }
    }
  }
}
{
  "clientCode": "Provided by BNPP PF",
  "shopCode": "Provided by BNPP PF",
  "newBusinessRequestType": {
    "application": {
      "brokerReference": "BROKERREF01",
      "accountNumber": null,
      "insuranceType": 1,
      "isRenewal": false,
      "allowSearchAuthorisation": true,
      "isCustomerPresent": true,
      "hasCustomerDeclaration": true
    },
    "policy": {
      "policyInceptionDate": "2020-11-04",
      "policyRenewalDate": "2021-11-04",
      "totalCashPrice": 1320.00,
      "deposit": 132.00,
      "creditProductCode": "TIN1",
      "term": 10,
      "preferredPaymentDay": 15,
      "policyPremiumAmount": 132.00,
      "brokerCreditFeeAmount": 10.0,
      "brokerCreditFeeDescription": "fees",
      "brokerFeeAmount": 120.0,
      "brokerFeeAmountDescription": "discount applicable",
      "addOnAmount": 5.0,
      "addOnAmountDescription": "Heavy Duty",
      "discountAmount": 1.0,
      "discountAmountDescription": "Discount",
      "premiumDescription": "1",
      "policyType": 1,
      "policyNumber": "mh-123456",
      "insuranceCompany": "7",
      "ropRateType": 1,
      "isEdiFlag": false
    },
    "applicant": {
      "customer": {
        "title": "Mr",
        "firstName": "Test01FN",
        "lastName": "Test01LN",
        "dateOfBirth": "1966-10-09",
        "nationality": "GBR",
        "countryOfBirth": "GBR",
        "email": "[email protected]",
        "policyholderName": "MW FORREST",
        "address": {
          "houseName": null,
          "houseNumber": "1",
          "streetName": "CROMWELL ROAD",
          "townland": "ELY",
          "postTown": "ELY",
          "county": null,
          "postCode": "CB6 1AS",
          "addressLineOne": null
        },
        "yearsAtAddress": 2,
        "previousAddress": {
          "houseName": null,
          "houseNumber": "1",
          "streetName": "CROMWELL ROAD",
          "townland": "ELY",
          "postTown": "ELY",
          "county": null,
          "postCode": "CB6 1AS",
          "addressLineOne": null
        },
        "telephone": {
          "mobileNumber": "07700900624",
          "phoneNumber": "01632960183"
        },
        "employment": {
          "employmentStatus": "FT",
          "employmentLevelSpecified": false,
          "industrySector": "1",
          "employmentSector": "1"
        }
      },
      "payment": {
        "isJointAccount": false,
        "isApplicantAccount": true,
        "thirdPartyAccountName": null,
        "thirdPartyApplicantAddress": null
      },
      "bank": {
        "bankAccountNumber": "41011166",
        "bankSortCode": "201596",
        "iban": null,
        "bic": null
      },
      "income": {
        "netMonthlyIncome": 27800.00
      }
    }
  }
}

Response Example

{
    "data": {
        "newBusinessResponseType": {
            "brokerReference": "BROKERREF01",
            "accountNumber": "910000014759",
            "decision": 1,
            "pdf": "",//base64 encoded bytes for a pdf
            "responseStatus": 1
        },
        "errors": null
    },
    "validationErrors": [],
    "error": -1,
    "error_description": null,
    "successful": true
}