Update policy

https://nqach-api.nqa.eks.insly.training/api/policy/update

Description

Update policy.

Example request

API token
output
Customer OID
Policy OID
Effective Date
Customer name
E-mail address
Phone
Birth date
Name of additional policy holder
Post Code
Address ID (AddressCloud)
Full Address
UDPRN
UMRRN
Buildings Policy Excess
Contents Policy Excess
Single Article Limit
Single Article Limit Personal Possessions
Products

Request parameters

ParameterTypeReqdDescriptionOptions

Response parameters

Parameter Type Description
status integer Status
response string Response object

Json request example

{
    "ajax_url": "/api/policy/update",
    "policy_oid": {{policy_oid}},
    "customer_oid": {{customer_oid}},
    "post_code": "BD18 1DZ",
    "address_id": "8e1942cc0c8e76f:xJeuH9",
    "full_address": "248 Leeds Road, Shipley BD18 1DZ",
    "effective_date": "",
    "name": "Rafael Random",
    "email": "rafa.random@gmail.com",
    "phone": "07763080139",
    "birthdate": "10/12/1988",
    "policy_name_additional": "Maria Jose",
    "home_buildings_policy_excess": 400,
    "home_contents_policy_excess": 500,
    "home_single_article_limit": 3000,
    "products": {
        "combined": [
            "personal_possessions",
            "core"
        ]
    }
}

Json response example

{
    "status": "1",
    "response": {
        "declined": false,
        "ipt_percent": "12.0000",
        "is_annual": false,
        "is_mta_diff_negative": true,
        "mta_offer_oid": "13168959",
        "customer_oid": 12984058,
        "core_payable": -428.61,
        "mta_payable": -630.15,
        "administration_fee": 0,
        "broker_fee": 0,
        "experian_fee": null,
        "policy_no": "OCC000620475A",
        "start_date": "2026-02-04",
        "end_date": "2027-02-03",
        "excess": "100",
        "claims_no": 0,
        "charge": {
            "refund": true,
            "source": {
                "name": null,
                "last4": null,
                "exp_month": null,
                "exp_year": null
            }
        },
        "close_brothers": {
            "total_amount_payable": 0,
            "number_of_instalments_left": 0,
            "first_instalment_amount": 0,
            "subsequent_instalment_amount": 0,
            "credit_charge": 0,
            "original_first_instalment_amount": 96.95,
            "original_subsequent_instalment_amount": 96.92
        },
        "products": {
            "combined": [
                "core",
                "personal_possessions"
            ]
        },
        "covers": {
            "13168885": {
                "combined": {
                    "Combined (Buildings and Contents)": {
                        "name": "Combined (Buildings and Contents)",
                        "premium_raw": 728.67,
                        "sub_product_tag": "core"
                    },
                    "Accidental Damage": {
                        "name": "Accidental Damage",
                        "premium_raw": 128.97,
                        "sub_product_tag": "accidental_damage"
                    },
                    "Personal Possessions": {
                        "name": "Personal Possessions",
                        "premium_raw": 113.84,
                        "sub_product_tag": "personal_possessions"
                    },
                    "Legal Expenses": {
                        "name": "Legal Expenses",
                        "premium_raw": 24.49,
                        "sub_product_tag": "legal_protection"
                    },
                    "Home Emergency": {
                        "name": "Home Emergency",
                        "premium_raw": 39.99,
                        "sub_product_tag": "home_emergency"
                    }
                }
            },
            "13168959": {
                "combined": {
                    "Combined (Buildings and Contents)": {
                        "name": "Combined (Buildings and Contents)",
                        "premium_raw": 253.5,
                        "sub_product_tag": "core"
                    },
                    "Personal Possessions": {
                        "name": "Personal Possessions",
                        "premium_raw": 102.93,
                        "sub_product_tag": "personal_possessions"
                    }
                }
            },
            "13168954": {
                "combined": {
                    "Combined (Buildings and Contents)": {
                        "name": "Combined (Buildings and Contents)",
                        "premium_raw": 246.86,
                        "sub_product_tag": "core"
                    },
                    "Personal Possessions": {
                        "name": "Personal Possessions",
                        "premium_raw": 97.19,
                        "sub_product_tag": "personal_possessions"
                    }
                }
            }
        },
        "premiums": {
            "extensions": {
                "total": {
                    "annual": {
                        "buildings": {
                            "ad": 23.84,
                            "home_emergency": 39.99,
                            "personal_possessions": 0,
                            "legal_protection": 24.49
                        },
                        "contents": {
                            "ad": 29.99,
                            "home_emergency": 39.99,
                            "personal_possessions": 107.6,
                            "legal_protection": 24.49
                        },
                        "combined": {
                            "ad": 53.22,
                            "home_emergency": 39.99,
                            "personal_possessions": 102.93,
                            "legal_protection": 24.49
                        }
                    },
                    "monthly": {
                        "buildings": {
                            "ad": 2.17,
                            "home_emergency": 3.63,
                            "personal_possessions": 0,
                            "legal_protection": 2.23
                        },
                        "contents": {
                            "ad": 2.73,
                            "home_emergency": 3.63,
                            "personal_possessions": 9.79,
                            "legal_protection": 2.23
                        },
                        "combined": {
                            "ad": 4.85,
                            "home_emergency": 3.63,
                            "personal_possessions": 9.37,
                            "legal_protection": 2.23
                        }
                    }
                },
                "gross": {
                    "annual": {
                        "buildings": {
                            "ad": 20.99,
                            "home_emergency": 35.21,
                            "personal_possessions": 0,
                            "legal_protection": 21.56
                        },
                        "contents": {
                            "ad": 26.41,
                            "home_emergency": 35.21,
                            "personal_possessions": 94.74,
                            "legal_protection": 21.56
                        },
                        "combined": {
                            "ad": 46.87,
                            "home_emergency": 35.21,
                            "personal_possessions": 90.63,
                            "legal_protection": 21.56
                        }
                    },
                    "monthly": {
                        "buildings": {
                            "ad": 1.91,
                            "home_emergency": 3.2,
                            "personal_possessions": 0,
                            "legal_protection": 1.96
                        },
                        "contents": {
                            "ad": 2.4,
                            "home_emergency": 3.2,
                            "personal_possessions": 8.62,
                            "legal_protection": 1.96
                        },
                        "combined": {
                            "ad": 4.27,
                            "home_emergency": 3.2,
                            "personal_possessions": 8.25,
                            "legal_protection": 1.96
                        }
                    }
                },
                "ipt": {
                    "annual": {
                        "buildings": {
                            "ad": 2.52,
                            "home_emergency": 4.23,
                            "personal_possessions": 0,
                            "legal_protection": 2.59
                        },
                        "contents": {
                            "ad": 3.17,
                            "home_emergency": 4.23,
                            "personal_possessions": 11.37,
                            "legal_protection": 2.59
                        },
                        "combined": {
                            "ad": 5.62,
                            "home_emergency": 4.23,
                            "personal_possessions": 10.88,
                            "legal_protection": 2.59
                        }
                    },
                    "monthly": {
                        "buildings": {
                            "ad": 0.23,
                            "home_emergency": 0.38,
                            "personal_possessions": 0,
                            "legal_protection": 0.24
                        },
                        "contents": {
                            "ad": 0.29,
                            "home_emergency": 0.38,
                            "personal_possessions": 1.03,
                            "legal_protection": 0.24
                        },
                        "combined": {
                            "ad": 0.51,
                            "home_emergency": 0.38,
                            "personal_possessions": 0.99,
                            "legal_protection": 0.24
                        }
                    }
                },
                "net_to_distributor": {
                    "annual": {
                        "buildings": {
                            "ad": 16.79,
                            "home_emergency": null,
                            "personal_possessions": 0,
                            "legal_protection": null
                        },
                        "contents": {
                            "ad": 21.13,
                            "home_emergency": null,
                            "personal_possessions": 75.79,
                            "legal_protection": null
                        },
                        "combined": {
                            "ad": 37.5,
                            "home_emergency": null,
                            "personal_possessions": 72.5,
                            "legal_protection": null
                        }
                    }
                }
            },
            "core": {
                "total": {
                    "annual": {
                        "buildingsValue": 200.77,
                        "contentsValue": 200.77,
                        "combinedValue": 253.5
                    },
                    "monthly": {
                        "buildingsValue": 35.6,
                        "contentsValue": 35.6,
                        "combinedValue": 40.39
                    }
                },
                "gross": {
                    "annual": {
                        "buildingsValue": 160,
                        "contentsValue": 160,
                        "combinedValue": 206.43
                    },
                    "monthly": {
                        "buildingsValue": 14.56,
                        "contentsValue": 14.56,
                        "combinedValue": 18.79
                    }
                },
                "ipt": {
                    "annual": {
                        "buildingsValue": 19.2,
                        "contentsValue": 19.2,
                        "combinedValue": 24.77
                    },
                    "monthly": {
                        "buildingsValue": 1.75,
                        "contentsValue": 1.75,
                        "combinedValue": 2.25
                    }
                },
                "net_to_distributor": {
                    "annual": {
                        "buildingsValue": 128,
                        "contentsValue": 128,
                        "combinedValue": 165.14
                    },
                    "monthly": {
                        "buildingsValue": 11.65,
                        "contentsValue": 11.65,
                        "combinedValue": 15.03
                    }
                }
            }
        },
        "payment_intent": null
    },
    "apirequest_oid": "13168956"
}
CUSTOMER SUPPORT support@insly.com