Get Coverage States by Program and Effective Date

get

https://{environment}.origamirisk.com/OrigamiApi/api/Quotes/InsurancePrograms/{insuranceProgramID}/ListStates

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Overview

Returns all states available across a given insurance program's rating companies, filtered to those active as of the provided effective date. Use this to populate state selection dropdowns when quoting within a specific insurance program.

Unlike the Lookups/States endpoint (which filters by a single rating company) this endpoint aggregates states across all rating companies assigned to the insurance program. If the insurance program has no carriers explicitly assigned, the endpoint treats all rating companies as applicable and returns states from all of them.

Results are sorted alphabetically by Description (full state name).

Path Params

insuranceProgramID

integer

required

An insurance program represents a configured product offering. It groups together a policy set, one or more lines of business, and one or more rating companies (carriers). When a user creates a quote, the insurance program determines which carriers, policy lines, and states are available for selection.

Each insurance program is scoped to a client and has a DisplayCode and Description (e.g., "WC-2026" / "Workers' Compensation 2026"). The insuranceProgramID is typically obtained from the Origami UI or from the insurance program selection step in a quoting workflow.

The Quotes API also provides companion endpoints for the same insurance program:

GET InsurancePrograms/{insuranceProgramID}/ListCarriers — list the program's rating companies*
GET InsurancePrograms/{insuranceProgramID}/ListPolicyLines — list the program's lines of business

Depending on your Origami configuration settings, you may see "Carrier", "Rating Company", "Insurer", "Underwriter" used interchangabely.

Query Params

effectiveDate

date-time

required

The policy effective date. Used to filter the insurance program's carriers to those whose effective/expiration date range includes this date. Use ISO format: 2027-01-15.

Response

Overview

200