Retrieve files provided by institutions.

Across the policy lifecycle, institutions can provide different types of files. For example, many institutions provide a quote summary in the form of a PDF to accompany a quote, and policy documents to accompany a bound policy. Availability of these files can vary depending on the institution and line of business.

Herald has made these files available via API because they can contain additional information that is not available via the API response.

[.icon-square-blue][.icon-square-blue]Herald is continuously expanding our file offering. If you would like a file that is not listed in our list of supported file types, please reach out to our team at

Files at Herald

The files Herald provides via API come directly from the institution. When a supported file is available, we will provide details to access this file in a files array of the relevant response. Herald currently supports multiple types of files for quotes, so our quote response always includes the files array. If Herald has obtain files from an institution for a given quote, the details of that file will be provided like this:

GET /quotes/{quote_id}

  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "product_id": "prd_mc4r_herald_general_liability",
  "status": "active",
  "files": [
      "id": "d7c4579a-5450-4e79-bcfc-e918b3c8a564",
      "type": "quote_summary",
      "text": "Quote Summary",
      "status": "available"

Learn how to get additional metadata on a file, as well as the actual contents of a file, in our guide to getting files.

While the files are provided by the institution, Herald downloads and hosts each individual file. Depending on the type of file, it may be deleted after a certain period of time which is communicated by a files [.h-code]status[.h-code].