aid: herald url: https://raw.githubusercontent.com/api-evangelist/herald/refs/heads/main/apis.yml name: Herald kind: company description: Herald builds digital infrastructure for commercial insurance, providing a single unified REST API that lets software platforms quote and bind across many carriers and lines of business. Developers create applications, submit them to carriers, and receive normalized quotes, products, classifications, and files through one integration secured with OAuth2 client-credentials bearer tokens. image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg tags: - Insurance - Insurtech - Commercial Insurance - Quoting - Carriers created: '2026-06-25' modified: '2026-06-25' specificationVersion: '0.19' apis: - aid: herald:applications name: Herald Applications API tags: - Applications - Risk Values - Coverage Values image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://docs.heraldapi.com/docs/heraldapi/5c69a421b6680-api-reference baseURL: https://api.heraldapi.com properties: - url: https://www.heraldai.com/docs/application type: Documentation - url: https://docs.heraldapi.com/docs/heraldapi/5c69a421b6680-api-reference type: APIReference - url: openapi/herald-openapi.yml type: OpenAPI - url: collections/herald.postman_collection.json type: PostmanCollection - url: collections/herald.opencollection.json type: OpenCollection description: Create and manage commercial-insurance applications for a set of products, supplying risk_values and coverage_values until the application is complete and ready to submit to carriers. - aid: herald:quotes name: Herald Quotes API tags: - Quotes - Submissions - Binding image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://www.heraldapi.com/docs/quotes baseURL: https://api.heraldapi.com properties: - url: https://www.heraldapi.com/docs/quotes type: Documentation - url: openapi/herald-openapi.yml type: OpenAPI - url: collections/herald.postman_collection.json type: PostmanCollection - url: collections/herald.opencollection.json type: OpenCollection description: Submit completed applications to carriers via submissions and retrieve normalized quotes, polling individual quotes by quote_id until each quote and its files reach an available status. - aid: herald:products name: Herald Products API tags: - Products - Producers - Appetite image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://www.heraldai.com/docs/products baseURL: https://api.heraldapi.com properties: - url: https://www.heraldai.com/docs/products type: Documentation - url: openapi/herald-openapi.yml type: OpenAPI - url: collections/herald.postman_collection.json type: PostmanCollection - url: collections/herald.opencollection.json type: OpenCollection description: List the insurance products a producer has access to, each identified by a unique product_id describing the carrier and line of business along with its appetite and underwriting question set. - aid: herald:classifications name: Herald Classifications API tags: - Classifications - NAICS - Industry Codes image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://www.heraldai.com/docs/classifications baseURL: https://api.heraldapi.com properties: - url: https://www.heraldai.com/docs/classifications type: Documentation - url: openapi/herald-openapi.yml type: OpenAPI - url: collections/herald.postman_collection.json type: PostmanCollection - url: collections/herald.opencollection.json type: OpenCollection description: Look up Herald's normalized NAICS index-entry classifications, where each Herald Code maps to the corresponding carrier code for every supported product so risk can be classified consistently across carriers. - aid: herald:distributors name: Herald Distributors API tags: - Distributors - Producers - Onboarding image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://www.heraldai.com/docs/create-and-manage-distributors baseURL: https://api.heraldapi.com properties: - url: https://www.heraldai.com/docs/create-and-manage-distributors type: Documentation - url: openapi/herald-openapi.yml type: OpenAPI - url: collections/herald.postman_collection.json type: PostmanCollection - url: collections/herald.opencollection.json type: OpenCollection description: Create and manage distributors - the organizational layer above producers - then create and list the producers beneath each distributor that connect to products and submit applications. - aid: herald:files name: Herald Files API tags: - Files - Documents - Downloads image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://www.heraldai.com/docs/getting-files baseURL: https://api.heraldapi.com properties: - url: https://www.heraldai.com/docs/getting-files type: Documentation - url: openapi/herald-openapi.yml type: OpenAPI - url: collections/herald.postman_collection.json type: PostmanCollection - url: collections/herald.opencollection.json type: OpenCollection description: Retrieve file metadata by file_id and generate temporary download links for quote letters, applications, and policy documents once a file reaches an available status. - aid: herald:webhooks name: Herald Webhooks API tags: - Webhooks - Events - Notifications image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://www.heraldai.com/docs/webhooks baseURL: https://api.heraldapi.com properties: - url: https://www.heraldai.com/docs/webhooks type: Documentation - url: openapi/herald-openapi.yml type: OpenAPI - url: collections/herald.postman_collection.json type: PostmanCollection - url: collections/herald.opencollection.json type: OpenCollection description: Register webhook subscriptions and receive POST callbacks for status-change and creation events such as quote, file, and policy status updates and submission creation, retried on non-200 responses. common: - type: LinkedIn url: https://www.linkedin.com/company/heraldapi - type: Website url: https://www.heraldapi.com - type: Documentation url: https://docs.heraldapi.com - type: Plans url: plans/herald-plans-pricing.yml - type: RateLimits url: rate-limits/herald-rate-limits.yml - type: FinOps url: finops/herald-finops.yml maintainers: - FN: Kin Lane email: kin@apievangelist.com