Gets a new quote for a given buyer, seller and invoice. The buyer, seller and invoice details are specified as JSON in the request body.
The Request Quote endpoint provides the means for users to obtain insurance coverage quotes for invoices.
Dealing with daylight saving
Please note that when dealing with dates, the timezone may need special attention as changes to daylight savings time may affect the overall quote duration.
Once these are submitted to the endpoint via a POST request, Single-Invoice.co will provide a quote response, which will include information about whether or not the quote was accepted and the pricing (see the "Results" section above for a sample response).
The 'status' field in the response will inform the user as to the outcome of the request. The two most important values for this field after issuing a request for a quote are "Pending" and "Rejected". (There are other values for this field; please see the Get Cover By ID page for a full list of the status types.)
Pricing in the Sandbox
Please note that if you're using our Sandbox environment for development or testing, the pricing returned in our Sandbox environment may not be reflective or indicative of the true pricing, or availability of coverage. Quotes in the Sandbox environment are not binding.
Pending
The "Pending" result means that Single-Invoice.co is able to provide coverage for this particular invoice. The cost of the coverage is also supplied with the response.
Users then will evaluate the cost based on their requirements and decide whether or not to proceed. Quotes are valid for a set period (dictated by your policy); at any time during this period they can be accepted (or rejected) by the user. After the period, the quote will automatically be expired by the system and will no longer be available; a new quote will need to be made for the invoice.
If the user is happy with the quote and wishes to proceed, the next step is to Activate the coverage. Alternatively, if coverage is not required for this invoice, the Reject method would be used.
| Output field | Description |
|---|---|
| currency | Currency of the policy |
| quotedAt | Quotation timestamp showing what time the quote was delivered |
| duration | The period of coverage (in days) that is being offered. Typically, coverage is calculated to the invoice due date. For example, coverage starting today and due tomorrow would return a duration of 2 |
| bpsperday | The rate we are offering for insurance in "basis points per day" |
| coverPrice | The total cost of the coverage (inclusive of any fees and taxes). |
| serviceFeeRate | Service fee on insurance rate excluding VAT |
| serviceFee | Service fee on insurance amount excluding VAT |
| serviceFeeVatRate | VAT rate applied on the service fee |
| serviceFeeVatAmount | VAT amount applied on the service fees |
| collectionFeeRate | Collection fee rate excluding VAT |
| collectionFeeAmount | Collection fee amount excluding VAT |
| collectionFeeVatRate | VAT rate applied on the collection fee |
| collectionFeeVatAmount | VAT amount applied on the collection fee |
| vat | VAT amount applied on the service fees (deprecated: duplicate of serviceFeeVatAmount) |
| insuranceTaxAmount | Insurance tax amount |
| insuranceTaxRate | Insurance tax rate |
Rejected
The "Rejected" result means that Single-Invoice.co cannot provide coverage for the supplied invoice.
If an invoice is marked as rejected, it will also include a new "rejectedby" field in the coverage section with the name of the rejecting party. If it's rejected by the API, this field will typically be "Single-Invoice.co", but if it's rejected by the user it will be simply be "User".
The common rejection reasons from Single-Invoice.co are the following:
- Not insurable.
- Not insurable: the buyer has an unpaid invoice past the maximum days defined by your policy.
- Not insurable: cover duration cannot be shorter than the minimum cover duration allowed by policy.
- Buyer and Seller share a group head company link.
- Not insurable: missing information about the buyer.
- Not insurable: Cover end date cannot be further than the maximum allowed by policy.
- Not insurable: invoice due date too old.
- Maximum exposure reached.
- Quote exceeds threshold