Partner with Re:New
Re:New Quote Request Webservice v1.1.0

Submit a quote request

POST/car-insurance/webservice/quote-request/json/

API for submitting lightweight quote requests to the Re:New Broking platform. Re:New retrieves the full risk data from the broker's source system using the supplied policy reference and submits it for quoting against the Re:New panel.

Refer type:

  • full — Re:New presents quotes to the customer end-to-end.
  • soft — Re:New returns the best available premium to the broker via

best_premium, with no customer-facing journey.

Consent flow:

  • When consent_obtained is true, Re:New proceeds to quote immediately.
  • When consent_obtained is false, the customer receives an email inviting

them to consent. Quoting is deferred until they click through.

Submits a lightweight referral to Re:New. The platform retrieves the full risk data for the given policy from the broker's source system and submits it for quoting against the Re:New panel.

If consent has not been obtained, quoting is deferred until the customer provides consent via the email link.

Test environment
https://renewbroking-test.sostec.co.uk
Production environment
https://renewbroking.sostec.co.uk
Authentication
None in headers. The caller is identified by an id in the body, which the portal sets for you.

Request body

application/json, required

quoteobjectrequired
#
broker_idstringrequired
#

Unique broker identifier assigned during onboarding. Used to resolve the broker's source system and credentials.

Example GOTY001

policy_refstringrequired
#

The policy reference from the broker's system. Used to retrieve the full risk data from the broker's source platform.

Example ANCX11PC01

refer_typestringrequired
#

Determines how Re:New handles the referral.

  • full — Re:New presents quotes to the customer end-to-end.
  • soft — Re:New returns the best available premium to the broker

via best_premium, with no customer-facing journey.

Example full

Allowed values
full
soft
consent_obtainedbooleanrequired
#

Whether the customer has already provided consent for their data to be used. When true, Re:New proceeds to quote immediately. When false, the customer is sent a consent email and quoting is deferred until they click through.

Example true

Responses

200Quote request accepted successfully
successbooleanoptional
#

Example true

messagestringoptional
#

Confirmation message

Example Quote request accepted

consent_pendingbooleanoptional
#

true when the request was accepted but quoting is deferred pending customer consent. false when quoting has been initiated immediately.

Example false

best_premiumstringoptional
#

The best available annual premium returned by the Re:New panel, formatted as a GBP currency string. Only populated when refer_type is soft. Returned as £0.00 when refer_type is full.

Example £412.57

Example 200 response
{
  "success": true,
  "message": "Quote request accepted",
  "consent_pending": false,
  "best_premium": "£412.57"
}
400Bad request — validation error in submitted data
successbooleanoptional
#

Example false

error_codestringoptional
#

Example VALIDATION_ERROR

messagestringoptional
#

Example Required field 'quote.policy_ref' is missing

Example 400 response
{
  "success": false,
  "error_code": "VALIDATION_ERROR",
  "message": "Required field 'quote.policy_ref' is missing"
}
401Unauthorised — invalid or unrecognised broker ID
successbooleanoptional
#

Example false

error_codestringoptional
#

Example VALIDATION_ERROR

messagestringoptional
#

Example Required field 'quote.policy_ref' is missing

Example 401 response
{
  "success": false,
  "error_code": "VALIDATION_ERROR",
  "message": "Required field 'quote.policy_ref' is missing"
}
500Internal server error
successbooleanoptional
#

Example false

error_codestringoptional
#

Example VALIDATION_ERROR

messagestringoptional
#

Example Required field 'quote.policy_ref' is missing

Example 500 response
{
  "success": false,
  "error_code": "VALIDATION_ERROR",
  "message": "Required field 'quote.policy_ref' is missing"
}

Schemas

QuoteRequest

quoteobjectrequired
#
broker_idstringrequired
#

Unique broker identifier assigned during onboarding. Used to resolve the broker's source system and credentials.

Example GOTY001

policy_refstringrequired
#

The policy reference from the broker's system. Used to retrieve the full risk data from the broker's source platform.

Example ANCX11PC01

refer_typestringrequired
#

Determines how Re:New handles the referral.

  • full — Re:New presents quotes to the customer end-to-end.
  • soft — Re:New returns the best available premium to the broker

via best_premium, with no customer-facing journey.

Example full

Allowed values
full
soft
consent_obtainedbooleanrequired
#

Whether the customer has already provided consent for their data to be used. When true, Re:New proceeds to quote immediately. When false, the customer is sent a consent email and quoting is deferred until they click through.

Example true

Quote

broker_idstringrequired
#

Unique broker identifier assigned during onboarding. Used to resolve the broker's source system and credentials.

Example GOTY001

policy_refstringrequired
#

The policy reference from the broker's system. Used to retrieve the full risk data from the broker's source platform.

Example ANCX11PC01

refer_typestringrequired
#

Determines how Re:New handles the referral.

  • full — Re:New presents quotes to the customer end-to-end.
  • soft — Re:New returns the best available premium to the broker

via best_premium, with no customer-facing journey.

Example full

Allowed values
full
soft
consent_obtainedbooleanrequired
#

Whether the customer has already provided consent for their data to be used. When true, Re:New proceeds to quote immediately. When false, the customer is sent a consent email and quoting is deferred until they click through.

Example true

SuccessResponse

successbooleanoptional
#

Example true

messagestringoptional
#

Confirmation message

Example Quote request accepted

consent_pendingbooleanoptional
#

true when the request was accepted but quoting is deferred pending customer consent. false when quoting has been initiated immediately.

Example false

best_premiumstringoptional
#

The best available annual premium returned by the Re:New panel, formatted as a GBP currency string. Only populated when refer_type is soft. Returned as £0.00 when refer_type is full.

Example £412.57

ErrorResponse

successbooleanoptional
#

Example false

error_codestringoptional
#

Example VALIDATION_ERROR

messagestringoptional
#

Example Required field 'quote.policy_ref' is missing

Changelog

  1. v1.1.0
    • Added refer_type: soft returns the best available price to you as best_premium, with no customer contact; full starts the customer journey and returns an acknowledgement.
    • The request body is wrapped in a parent quote object.
  2. v1.0.0
    • First release: broker_id, policy_ref and consent_obtained at the top level.