Quote Statuses
Learn how the status of a quote progresses
.jpg)
As soon as the submission is created you will be provided a [.h-code]quote_id[.h-code] in the submission response, with every quote beginning at a [.h-code]pending[.h-code] status. This status will persist as we communicate with the institution, eventually moving to:
- A Successfully Processed Status: Meaning the institution was able to process the submission and make a decision. That decision could be to provide a quote, which Herald calls [.h-code]active[.h-code], or to explicitly decline providing a quote, which Herald calls [.h-code]declined[.h-code]. The decision could also be to perform further review, which would be [.h-code]referral[.h-code] or [.h-code]referred[.h-code].
- An Unsuccessfully Processed Status: Meaning the institution was not able to process the submission. This could happen for a variety of reasons, such as the institutions API being down, or information not being submitted correctly.
Statuses
You can check the status of a quote using [.h-code]GET[.h-code] [.h-endpoint-link]/quotes/{quote_id}[.h-endpoint-link]. Quotes can have the following statuses:
Checking for Updates
[.icon-circle-blue][.icon-circle-blue] Herald offers webhooks for quotes. You can set up webhooks to receive updates as the quote status progresses.
As stated above, the time it takes for an institution to review a submission and provide a quote can vary depending on the product. After receiving a quote with a [.h-code]pending[.h-code] status, you have to poll [.h-code]GET[.h-code] [.h-endpoint-link]/quotes/{quote_id}[.h-endpoint-link] for updates. Eventually, usually within a few seconds to a few minutes, the quote will progress to a non-pending status.