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
Language
Authentication
Header
Click Try It! to start a request and see the response here!